Regions

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/daytonaio/daytona/llms.txt

Use this file to discover all available pages before exploring further.

​

Overview

• Reduce latency by placing sandboxes close to your users or data
• Comply with data residency requirements
• Distribute workloads across regions for better availability

​

Region Selection

​

Specify Target Region

import { Daytona } from '@daytonaio/sdk'

// Configure Daytona with a default region
const daytona = new Daytona({
  apiKey: 'your-api-key',
  target: 'us-east'  // Default region for all sandboxes
})

// Create sandbox in the default region
const sandbox = await daytona.create()

console.log(`Sandbox region: ${sandbox.target}`)

​

Environment Variable Configuration

export DAYTONA_API_KEY="your-api-key"
export DAYTONA_TARGET="us-east"

import { Daytona } from '@daytonaio/sdk'

// Uses DAYTONA_TARGET from environment
const daytona = new Daytona()
const sandbox = await daytona.create()

​

Multi-Region Deployment

​

Deploy to Multiple Regions

import { Daytona } from '@daytonaio/sdk'

// Create Daytona clients for different regions
const daytonaUSEast = new Daytona({ target: 'us-east' })
const daytonaEUWest = new Daytona({ target: 'eu-west' })
const daytonaAPSouth = new Daytona({ target: 'ap-south' })

// Deploy to multiple regions
const usEastSandbox = await daytonaUSEast.create({
  labels: { region: 'us-east', app: 'api' }
})

const euWestSandbox = await daytonaEUWest.create({
  labels: { region: 'eu-west', app: 'api' }
})

const apSouthSandbox = await daytonaAPSouth.create({
  labels: { region: 'ap-south', app: 'api' }
})

console.log('Multi-region deployment complete')

​

Region Information

​

Check Sandbox Region

const sandbox = await daytona.get('sandbox-id')

console.log(`Sandbox ID: ${sandbox.id}`)
console.log(`Region: ${sandbox.target}`)
console.log(`Organization: ${sandbox.organizationId}`)

​

List Sandboxes by Region

// List all sandboxes in a specific region
const usEastDaytona = new Daytona({ target: 'us-east' })
const result = await usEastDaytona.list()

console.log(`Sandboxes in us-east: ${result.total}`)
for (const sandbox of result.items) {
  console.log(`  ${sandbox.id} - ${sandbox.target}`)
}

​

Region-Specific Use Cases

​

Data Residency Compliance

// Create sandbox in EU region for GDPR compliance
const euDaytona = new Daytona({
  target: 'eu-west'
})

const gdprSandbox = await euDaytona.create({
  labels: {
    compliance: 'gdpr',
    data_region: 'eu'
  }
})

console.log(`GDPR-compliant sandbox in: ${gdprSandbox.target}`)

​

Low-Latency Access

// Create sandbox near user location
const getUserRegion = (userLocation: string): string => {
  const regionMap: Record<string, string> = {
    'north-america': 'us-east',
    'europe': 'eu-west',
    'asia': 'ap-south'
  }
  return regionMap[userLocation] || 'us-east'
}

const userLocation = 'europe'
const region = getUserRegion(userLocation)

const daytona = new Daytona({ target: region })
const sandbox = await daytona.create({
  labels: {
    user_region: userLocation
  }
})

console.log(`Created sandbox in ${sandbox.target} for ${userLocation}`)

​

Multi-Region Testing

const regions = ['us-east', 'eu-west', 'ap-south']
const sandboxes = []

for (const region of regions) {
  const daytona = new Daytona({ target: region })
  const sandbox = await daytona.create({
    snapshot: 'test-environment',
    labels: {
      test_id: 'multi-region-test',
      region: region
    }
  })
  sandboxes.push(sandbox)
  console.log(`Test sandbox created in ${region}`)
}

console.log(`Created ${sandboxes.length} test sandboxes`)

​

Region Configuration

​

Available Regions

• us-east - US East Coast
• us-west - US West Coast
• eu-west - Europe West
• eu-central - Europe Central
• ap-south - Asia Pacific South
• ap-northeast - Asia Pacific Northeast

​

Default Region

• The client uses the region from DAYTONA_TARGET environment variable
• If not set, uses your organization’s default region

​

Snapshots and Regions

const usEastDaytona = new Daytona({ target: 'us-east' })

// Create snapshot in us-east region
await usEastDaytona.snapshot.create(
  {
    name: 'my-snapshot',
    image: Image.debianSlim('3.12')
  },
  { onLogs: console.log }
)

// Use snapshot in the same region
const sandbox = await usEastDaytona.create({
  snapshot: 'my-snapshot'
})

console.log(`Sandbox and snapshot in: ${sandbox.target}`)

​

Resource Quotas

• Different resource limits per region
• Different available machine types per region
• Region-specific pricing

​

Best Practices

1. Choose the right region: Select regions based on user location, data location, and compliance requirements.
2. Use consistent regions: Keep related sandboxes (e.g., frontend and backend) in the same region for low latency.
3. Label by region: Use labels to track which region each sandbox belongs to.
4. Plan for snapshots: Remember that snapshots are region-specific and plan accordingly.
5. Monitor costs: Different regions may have different pricing structures.
6. Test multi-region: If deploying globally, test your application in all target regions.
7. Consider data transfer: Moving large amounts of data between regions can be slow and costly.

​

Region Configuration Reference

​

DaytonaConfig

interface DaytonaConfig {
  apiKey?: string
  apiUrl?: string
  target?: string  // Region identifier
}

​

Environment Variables

​

Related

• Resource Management - Configure resources by region
• Custom Images - Build images in specific regions
• Monitoring - Track regional sandbox usage