feat(api, dashboard, docs, sdk): default region for organization (#2792)

Signed-off-by: fabjanvucina <[email protected]>

Author: fabjanvucina

apps/api/src/app.service.ts

@@ -153,7 +153,9 @@ Admin user created with API key: ${value}
   }
 
   private async initializeBackupRegistry(): Promise<void> {
-    const existingRegistry = await this.dockerRegistryService.getAvailableBackupRegistry('us')
+    const existingRegistry = await this.dockerRegistryService.getAvailableBackupRegistry(
+      this.configService.getOrThrow('defaultRegion'),
+    )
     if (existingRegistry) {
       return
     }

apps/api/src/config/configuration.ts

@@ -202,6 +202,7 @@ const configuration = {
     maxSnapshotSize: parseInt(process.env.DEFAULT_ORG_QUOTA_MAX_SNAPSHOT_SIZE || '20', 10),
     volumeQuota: parseInt(process.env.DEFAULT_ORG_QUOTA_VOLUME_QUOTA || '100', 10),
   },
+  defaultRegion: process.env.DEFAULT_REGION || 'us',
 }
 
 export { configuration }

apps/api/src/migrations/1761912147638-migration.ts

@@ -0,0 +1,27 @@
+/*
+ * Copyright 2025 Daytona Platforms Inc.
+ * SPDX-License-Identifier: AGPL-3.0
+ */
+
+import { MigrationInterface, QueryRunner } from 'typeorm'
+import { configuration } from '../config/configuration'
+
+export class Migration1761912147638 implements MigrationInterface {
+  name = 'Migration1761912147638'
+
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`ALTER TABLE "organization" ADD "defaultRegion" character varying NULL`)
+    await queryRunner.query(`UPDATE "organization" SET "defaultRegion" = '${configuration.defaultRegion}'`)
+    await queryRunner.query(`ALTER TABLE "organization" ALTER COLUMN "defaultRegion" SET NOT NULL`)
+
+    await queryRunner.query(`ALTER TABLE "sandbox" ALTER COLUMN "region" DROP DEFAULT`)
+    await queryRunner.query(`ALTER TABLE "warm_pool" ALTER COLUMN "target" DROP DEFAULT`)
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`ALTER TABLE "organization" DROP COLUMN "defaultRegion"`)
+
+    await queryRunner.query(`ALTER TABLE "sandbox" ALTER COLUMN "region" SET DEFAULT 'us'`)
+    await queryRunner.query(`ALTER TABLE "warm_pool" ALTER COLUMN "target" SET DEFAULT 'us'`)
+  }
+}

apps/api/src/organization/dto/organization.dto.ts

@@ -98,6 +98,11 @@ export class OrganizationDto {
   })
   sandboxLimitedNetworkEgress: boolean
 
+  @ApiProperty({
+    description: 'Default region',
+  })
+  defaultRegion: string
+
   static fromOrganization(organization: Organization): OrganizationDto {
     const dto: OrganizationDto = {
       id: organization.id,
@@ -118,6 +123,7 @@ export class OrganizationDto {
       maxMemoryPerSandbox: organization.maxMemoryPerSandbox,
       maxDiskPerSandbox: organization.maxDiskPerSandbox,
       sandboxLimitedNetworkEgress: organization.sandboxLimitedNetworkEgress,
+      defaultRegion: organization.defaultRegion,
     }
 
     return dto

apps/api/src/organization/entities/organization.entity.ts

@@ -29,6 +29,9 @@ export class Organization {
   })
   telemetryEnabled: boolean
 
+  @Column()
+  defaultRegion: string
+
   @Column({
     type: 'int',
     default: 10,
@@ -152,4 +155,8 @@ export class Organization {
     type: 'timestamp with time zone',
   })
   updatedAt: Date
+
+  constructor(defaultRegion: string) {
+    this.defaultRegion = defaultRegion
+  }
 }

apps/api/src/organization/services/organization.service.ts

@@ -228,7 +228,9 @@ export class OrganizationService implements OnModuleInit, TrackableJobExecutions
       throw new ForbiddenException('You have reached the maximum number of created organizations')
     }
 
-    let organization = new Organization()
+    const defaultRegion = this.configService.getOrThrow('defaultRegion')
+
+    let organization = new Organization(defaultRegion)
 
     organization.name = createOrganizationDto.name
     organization.createdBy = createdBy

apps/api/src/sandbox/entities/sandbox.entity.ts

@@ -36,9 +36,7 @@ export class Sandbox {
   @Column()
   name: string
 
-  @Column({
-    default: 'us',
-  })
+  @Column()
   region: string
 
   @Column({
@@ -196,10 +194,11 @@ export class Sandbox {
   @Column({ nullable: true })
   daemonVersion?: string
 
-  constructor(name?: string) {
+  constructor(region: string, name?: string) {
     this.id = uuidv4()
     // Set name - use provided name or fallback to ID
     this.name = name || this.id
+    this.region = region
   }
 
   public setBackupState(

apps/api/src/sandbox/entities/warm-pool.entity.ts

@@ -17,9 +17,7 @@ export class WarmPool {
   @Column()
   snapshot: string
 
-  @Column({
-    default: 'us',
-  })
+  @Column()
   target: string
 
   @Column()

apps/api/src/sandbox/services/sandbox.service.ts

@@ -232,11 +232,10 @@ export class SandboxService {
   }
 
   async createForWarmPool(warmPoolItem: WarmPool): Promise<Sandbox> {
-    const sandbox = new Sandbox()
+    const sandbox = new Sandbox(warmPoolItem.target)
 
     sandbox.organizationId = SANDBOX_WARM_POOL_UNASSIGNED_ORGANIZATION
 
-    sandbox.region = warmPoolItem.target
     sandbox.class = warmPoolItem.class
     sandbox.snapshot = warmPoolItem.snapshot
     //  TODO: default user should be configurable
@@ -281,7 +280,7 @@ export class SandboxService {
     let pendingDiskIncrement: number | undefined
 
     try {
-      const region = this.getValidatedOrDefaultRegion(createSandboxDto.target)
+      const region = this.getValidatedOrDefaultRegion(organization, createSandboxDto.target)
       const sandboxClass = this.getValidatedOrDefaultClass(createSandboxDto.class)
 
       let snapshotIdOrName = createSandboxDto.snapshot
@@ -362,7 +361,7 @@ export class SandboxService {
         const warmPoolSandbox = await this.warmPoolService.fetchWarmPoolSandbox({
           organizationId: organization.id,
           snapshot: snapshotIdOrName,
-          target: createSandboxDto.target,
+          target: region,
           class: createSandboxDto.class,
           cpu: cpu,
           mem: mem,
@@ -386,12 +385,11 @@ export class SandboxService {
         snapshotRef: snapshot.internalName,
       })
 
-      const sandbox = new Sandbox(createSandboxDto.name)
+      const sandbox = new Sandbox(region, createSandboxDto.name)
 
       sandbox.organizationId = organization.id
 
       //  TODO: make configurable
-      sandbox.region = region
       sandbox.class = sandboxClass
       sandbox.snapshot = snapshot.name
       //  TODO: default user should be configurable
@@ -523,7 +521,7 @@ export class SandboxService {
     let pendingDiskIncrement: number | undefined
 
     try {
-      const region = this.getValidatedOrDefaultRegion(createSandboxDto.target)
+      const region = this.getValidatedOrDefaultRegion(organization, createSandboxDto.target)
       const sandboxClass = this.getValidatedOrDefaultClass(createSandboxDto.class)
 
       const cpu = createSandboxDto.cpu || DEFAULT_CPU
@@ -551,11 +549,10 @@ export class SandboxService {
         await this.volumeService.validateVolumes(organization.id, volumeIdOrNames)
       }
 
-      const sandbox = new Sandbox(createSandboxDto.name)
+      const sandbox = new Sandbox(region, createSandboxDto.name)
 
       sandbox.organizationId = organization.id
 
-      sandbox.region = region
       sandbox.class = sandboxClass
       sandbox.osUser = createSandboxDto.user || 'daytona'
       sandbox.env = createSandboxDto.env || {}
@@ -1082,9 +1079,9 @@ export class SandboxService {
     }
   }
 
-  private getValidatedOrDefaultRegion(region?: string): string {
+  private getValidatedOrDefaultRegion(organization: Organization, region?: string): string {
     if (!region || region.trim().length === 0) {
-      return 'us'
+      return organization.defaultRegion
     }
 
     return region.trim()

apps/cli/mcp/README.md

@@ -85,7 +85,7 @@ Note: if you are running Daytona MCP Server on Windows OS, add the following to
 
   - Parameters:
     - `id` (optional): Sandbox ID - if provided, an existing sandbox will be used, new one will be created otherwise
-    - `target` (default: "us"): Target region of the sandbox
+    - `target` (optional): Target region of the sandbox (if not provided, default region of the organization is used)
     - `image`: Image of the sandbox (optional)
     - `auto_stop_interval` (default: "15"): Auto-stop interval in minutes (0 means disabled)
     - `auto_archive_interval` (default: "10080"): Auto-archive interval in minutes (0 means the maximum interval will be used)