Regions

Every Daytona sandbox runs in a region: a geographic or logical grouping of compute infrastructure. When creating a sandbox, you can target a specific region, and Daytona schedules the workload on available capacity within that region. A create request that names no region uses the project's default region, then the organization's, then Earth.

Regions form one flat list, and each region names the broader regions it is inside, from Earth down to its direct parent. Earth covers every other region and means anywhere: a sandbox created in Earth can land in any geography.

A broader region lets Daytona place the sandbox anywhere inside it; a narrower region keeps the sandbox closer to you. Each region has its own price multiplier, applied to the base price of the sandbox's resources, and a region without one is billed at Earth's. The hierarchy does not set the price: a narrower region can cost less than its parent, so check the multiplier of the region you name. A listed region describes topology, not capacity: a create request can still fail for lack of capacity or matching hardware.

Shared regions

Regions managed by Daytona and available to all organizations:

from daytona import Daytona

daytona = Daytona()

# Create a sandbox anywhere in Earth
sandbox = daytona.v2.create(region="earth")

Operations

List regions

List regions. The list contains every region you can name in a create request, as one flat list in tree order: Earth first, then each region followed by the regions inside it. Each region names its parent regions, so a client can rebuild the hierarchy from the list. Regions that cannot be used are left out. A region that covers others stays listed when none of them accepts automatic placement, marked as unavailable, and cannot be named in a create request.

# Regions available to the current project, as NAME, ID, PRICE MULTIPLIER, and AVAILABLE columns
daytona region list

# Include parent regions
daytona region list --output json

List region price multipliers

List region price multipliers. The list contains the price multiplier of every region a create request can name, Earth first, then every other region ordered by ID. A sandbox's CPU, memory, GPU, and storage are billed at the base price times the multiplier of the region its create request named. A create request that names no region is billed at its default region's multiplier, or at Earth's when no default is set. For the other pricing dimensions, see billing.

# The PRICE MULTIPLIER column of the region list
daytona region list