Sandboxes and resources

Reference for the daytona cpu-type, disk-class, image, network-class, region, sandbox, snapshot, and volume commands.

Commands

This page documents the following commands. Global flags that apply to every command are listed under daytona.

Command	Description
`daytona cpu-type`	Inspect the CPU type catalog
`daytona disk-class`	List disk classes
`daytona image`	Manage images
`daytona network-class`	List network classes
`daytona region`	Inspect regions
`daytona sandbox`	Create and operate sandboxes
`daytona snapshot`	Manage snapshots
`daytona volume`	Manage volumes

Command	Description
`daytona cpu-type list`	List CPU types

With --region, also show which types have a live runner in that region: AVAILABLE is "exact" when a runner declares the type, "fallback" when a higher tier of the same architecture serves it, and "-" when nothing does.

daytona cpu-type list [flags]

Examples

daytona cpu-type list
daytona cpu-type list --region us-west-1

Flags

Long	Short	Type	Default	Description
`--region`		`string`		region slug: show availability from GET /cpu-catalog

daytona disk-class

List disk classes

Commands

Command	Description
`daytona disk-class list`	List disk classes

daytona disk-class list

List disk classes

daytona disk-class list

Examples

daytona disk-class list

daytona image

Manage images

Examples

daytona image list --all

Commands

Command	Description
`daytona image build`	Build an image from a Dockerfile context
`daytona image cache`	Inspect the shared image cache
`daytona image capture`	Capture a sandbox filesystem as an image
`daytona image create`	Import an image from a registry ref
`daytona image delete`	Delete an image
`daytona image get`	Get one image
`daytona image list`	List images
`daytona image logs`	Read image build logs
`daytona image promote`	Name an anonymous image, making it permanent

daytona image build

Build an image from a Dockerfile context

daytona image build <name> [flags]

Examples

daytona image build my-base --dockerfile Dockerfile --context .

Flags

Long	Short	Type	Default	Description
`--context`		`string`		path to the build context tar or directory
`--dockerfile`		`string`		path to the Dockerfile inside the context

daytona image cache

Inspect the shared image cache

Commands

Command	Description
`daytona image cache list`	List cache entries

daytona image cache list

List cache entries

daytona image cache list [flags]

Examples

daytona image cache list
daytona image cache list --ref python:3.12

Flags

Long	Type	Default	Description
`--all`	`bool`		follow every page until exhausted
`--cursor`	`string`		opaque continuation token
`--limit`	`int`	`100`	max rows to return
`--ref`	`string`		inspect one registry ref instead of listing

daytona image capture

Capture a sandbox filesystem as an image

daytona image capture <sandbox> [flags]

Examples

daytona image capture <sandbox> --name saved-image
daytona image capture <sandbox> --idle 3600

Flags

Long	Short	Type	Default	Description
`--idle`		`int`		idle-retention window in seconds for an anonymous capture: deleted once this long passes without a sandbox being created from it (omit or -1 = server max, 7 days by default; promote the image to keep it)
`--name`		`string`		image name

daytona image create

Import an image from a registry ref

daytona image create <name> [flags]

Aliases: import

Examples

daytona image create my-base --ref python:3.12

Flags

Long	Short	Type	Default	Description
`--ref`		`string`		registry ref to import

daytona image delete

Delete an image

daytona image delete <id>

Examples

daytona image delete <id> --yes

daytona image get

Get one image

daytona image get <id>

Examples

daytona image get <id>

daytona image list

List images

daytona image list [flags]

Examples

daytona image list --limit 20

Flags

Long	Type	Default	Description
`--all`	`bool`		follow every page until exhausted
`--anonymous`	`string`		filter by anonymous status: true\|false\|any
`--cursor`	`string`		opaque continuation token
`--limit`	`int`	`100`	max rows to return
`--name`	`string`		filter by exact image name
`--sandbox`	`string`		filter captures by source sandbox id

daytona image logs

Read image build logs

daytona image logs <id> [flags]

Examples

daytona image logs <id> --follow

Flags

Long	Short	Type	Default	Description
`--follow`		`bool`		follow until the build finishes

daytona image promote

Name an anonymous image, making it permanent

Name an anonymous image, making it permanent (PATCH /images/{id}). Promotion only: an image that already has a name answers 409 — renaming a named image is not offered.

daytona image promote <image> <name>

Examples

daytona image promote img_abc123 saved-image

daytona network-class

List network classes

Commands

Command	Description
`daytona network-class list`	List network classes

daytona network-class list

List network classes

daytona network-class list

Examples

daytona network-class list

daytona region

Inspect regions

Commands

Command	Description
`daytona region list`	List regions

daytona region list

List regions

daytona region list

Examples

daytona region list

daytona sandbox

Create and operate sandboxes

Create sandboxes, inspect their lifecycle, and run toolbox commands through the sandbox toolbox proxy.

Commands

Command	Description
`daytona sandbox cp`	Copy files to or from a sandbox
`daytona sandbox create`	Create a sandbox from an image
`daytona sandbox create-from-snapshot`	Create a sandbox by resuming a memory snapshot
`daytona sandbox delete`	Delete a sandbox
`daytona sandbox docker`	Inspect Docker Engine inside a sandbox
`daytona sandbox exec`	Run a command inside a sandbox
`daytona sandbox fork`	Fork a sandbox
`daytona sandbox get`	Get one sandbox
`daytona sandbox list`	List sandboxes
`daytona sandbox logs`	Read sandbox logs
`daytona sandbox pause`	Pause a sandbox
`daytona sandbox port`	Inspect sandbox ports
`daytona sandbox preview-url`	Mint a preview URL
`daytona sandbox process`	Inspect and control sandbox processes
`daytona sandbox resume`	Resume a sandbox
`daytona sandbox search`	Search sandboxes across the all-region index
`daytona sandbox ssh`	Open SSH through the sandbox gateway
`daytona sandbox start`	Start a sandbox
`daytona sandbox stop`	Stop a sandbox
`daytona sandbox update`	Update sandbox labels or lifecycle
`daytona sandbox usage`	Read sandbox usage
`daytona sandbox wait`	Wait for a sandbox status

daytona sandbox cp

Copy files to or from a sandbox

Copies one file over a pre-signed toolbox URL minted by the control plane (POST /vms/{id}/files/sign). With -r, destination handling matches POSIX cp -r: if the destination ends with / (or is an existing local directory on download), the source directory is copied into it as <dest>/<basename(src)>; otherwise the destination path is the new directory itself.

daytona sandbox cp <src> <dst> [flags]

Flags

Long	Short	Type	Default	Description
`--recursive`	`-r`	`bool`		copy a directory by uploading one tar archive, then extracting it remotely

daytona sandbox create

Create a sandbox from an image

Create a Linux sandbox from an image (POST /sandboxes). The SDK twin is create(image, …).

daytona sandbox create [flags]

Examples

daytona sandbox create --image py312
daytona sandbox create --image py312 --name mate --wait 60 --create-ttl 3600

Flags

Long	Type	Description
`--allow-cidr`	`stringArray`	network policy: allowed IPv4 address or CIDR, any port (repeatable; needs --block-all or --allow-domain)
`--allow-domain`	`stringArray`	network policy: allowed hostname or *.wildcard (repeatable; implies --block-all)
`--block-all`	`bool`	network policy: deny all egress not explicitly allowed
`--cpu`	`float`	guaranteed CPU cores
`--cpu-arch`	`string`	CPU architecture constraint
`--cpu-type`	`string`	CPU type constraint
`--create-ttl`	`int`	deadline in seconds for the sandbox to reach running (queued or booting) before the server deletes it (-1 = server max)
`--disk`	`int32`	scratch disk in MiB
`--disk-max`	`int32`	scratch disk limit in MiB; equal to --disk for a fixed shape
`--env`	`stringArray`	environment variable KEY=VALUE (repeatable)
`--idempotency-key`	`string`	idempotency key
`--idle-timeout`	`int`	idle seconds until --on-idle-timeout fires
`--image`	`string`	image name or img_… id (required)
`--label`	`stringArray`	label KEY=VALUE (repeatable)
`--mem-max`	`int32`	memory limit in MiB; equal to --memory for a fixed shape
`--memory`	`int32`	memory in MiB
`--name`	`string`	sandbox name
`--on-idle-timeout`	`string`	action when --idle-timeout elapses: stop\|pause\|delete
`--on-timeout`	`string`	action when --timeout elapses: stop\|pause\|delete
`--persistent`	`bool`	use a persistent write layer
`--port`	`stringArray`	port as PORT or PORT/PROTO (repeatable)
`--secret`	`stringArray`	secret name to attach (repeatable)
`--spot`	`bool`	use the spot tier
`--timeout`	`int`	wall-clock seconds until --on-timeout fires (re-arms on every start)
`--user`	`string`	default sandbox OS user
`--vcpus`	`int32`	whole vCPU count
`--vcpus-max`	`int32`	vCPU limit (boot shape and CPU ceiling); equal to --cpu for a fixed shape
`--volume`	`stringArray`	volume mount VOLUME:MOUNT_PATH[:SUBPATH][:ro] (repeatable; a trailing :ro mounts read-only)
`--wait`	`int`	server-side wait budget in seconds before the create response returns
`--wake-on-request`	`bool`	wake a parked sandbox on traffic

daytona sandbox create-from-snapshot

Create a sandbox by resuming a memory snapshot

Resume a memory snapshot as a new Linux sandbox (POST /sandboxes/from-snapshot). The SDK twin is create_from_snapshot(snapshot, …). Resources come from the snapshot; only name, labels, ports, lifecycle, wait and create-ttl apply.

daytona sandbox create-from-snapshot <snapshot-name-or-snap_id> [flags]

Examples

daytona sandbox create-from-snapshot after-setup --name resumed

Flags

Long	Type	Description
`--create-ttl`	`int`	deadline in seconds for the sandbox to reach running (queued or booting) before the server deletes it (-1 = server max)
`--idempotency-key`	`string`	idempotency key
`--idle-timeout`	`int`	idle seconds until --on-idle-timeout fires
`--label`	`stringArray`	label KEY=VALUE (repeatable)
`--name`	`string`	sandbox name
`--on-idle-timeout`	`string`	action when --idle-timeout elapses: stop\|pause\|delete
`--on-timeout`	`string`	action when --timeout elapses: stop\|pause\|delete
`--port`	`stringArray`	port as PORT or PORT/PROTO (repeatable)
`--timeout`	`int`	wall-clock seconds until --on-timeout fires (re-arms on every start)
`--wait`	`int`	server-side wait budget in seconds before the create response returns
`--wake-on-request`	`bool`	wake a parked sandbox on traffic

daytona sandbox delete

Delete a sandbox

daytona sandbox delete <id>

Examples

daytona sandbox delete <id>

daytona sandbox docker

Inspect Docker Engine inside a sandbox

Examples

daytona sandbox docker status <id>
daytona sandbox docker status <id> --wait

Commands

Command	Description
`daytona sandbox docker status`	Read Docker Engine status inside a sandbox

daytona sandbox docker status

Read Docker Engine status inside a sandbox

--wait polls until Docker is ready; if --timeout is not set, the command uses the SDK default wait budget of 60s.

daytona sandbox docker status <sandbox-id> [flags]

Flags

Long	Short	Type	Default	Description
`--wait`		`bool`		wait until Docker reaches ready

daytona sandbox exec

Run a command inside a sandbox

Starts a sandbox process through the toolbox proxy, streams its output, and exits with the process exit code.

daytona sandbox exec <sandbox-id> -- <command> [args...] [flags]

Examples

daytona sandbox exec sbx-123 -- python -V
printf hi | daytona sandbox exec sbx-123 -- cat
daytona sandbox exec sbx-123 --tty -- bash

Flags

Long	Type	Description
`--cwd`	`string`	working directory inside the sandbox
`--env`	`stringArray`	environment variable to set (KEY=VALUE, repeatable)
`--tty`	`bool`	run the command in a PTY and attach interactively
`--user`	`string`	sandbox OS user to run the command as

daytona sandbox fork

Fork a sandbox

daytona sandbox fork <id> [flags]

Examples

daytona sandbox fork <id>

Flags

Long	Short	Type	Default	Description
`--name`		`string`		fork name

daytona sandbox get

Get one sandbox

Get one sandbox by id.

daytona sandbox get <id>

Examples

daytona sandbox get <id>

daytona sandbox list

List sandboxes

List sandboxes across regions.

daytona sandbox list [flags]

Examples

daytona sandbox list
daytona sandbox list --region us-west-1 --limit 20

Flags

Long	Type	Default	Description
`--all`	`bool`		follow every page until exhausted
`--cursor`	`string`		opaque continuation token
`--limit`	`int`	`100`	max rows to return

daytona sandbox logs

Read sandbox logs

daytona sandbox logs <id> [flags]

Examples

daytona sandbox logs <id>
daytona sandbox logs <id> --entrypoint

Flags

Long	Short	Type	Default	Description
`--entrypoint`		`bool`		read entrypoint logs
`--follow`		`bool`		poll for new log bytes until interrupted

daytona sandbox pause

Pause a sandbox

daytona sandbox pause <id>

Examples

daytona sandbox pause <id>

daytona sandbox port

Inspect sandbox ports

Commands

Command	Description
`daytona sandbox port list`	List listening ports inside a sandbox

daytona sandbox port list

List listening ports inside a sandbox

daytona sandbox port list <sandbox-id>

daytona sandbox preview-url

Mint a preview URL

daytona sandbox preview-url <id> <port> [flags]

Examples

daytona sandbox preview-url <id> 8080
daytona sandbox preview-url <id> 8080 --signed --ttl 300

Flags

Long	Short	Type	Default	Description
`--signed`		`bool`		mint a short-lived signed preview URL
`--ttl`		`int`	`60`	signed preview TTL in seconds

Commands

Command	Description
`daytona sandbox preview-url expire`	Expire one signed preview URL

daytona sandbox preview-url expire

Expire one signed preview URL

daytona sandbox preview-url expire <id> <port> <token>

Examples

daytona sandbox preview-url expire <id> 8080 <token>

daytona sandbox process

Inspect and control sandbox processes

Lists, gets, waits for, signals, kills, logs, and attaches to sandbox processes through the toolbox proxy.

Commands

Command	Description
`daytona sandbox process attach`	Attach to a process websocket stream
`daytona sandbox process get`	Fetch one process
`daytona sandbox process kill`	Send SIGKILL to a process
`daytona sandbox process list`	List processes in a sandbox
`daytona sandbox process logs`	Read process logs
`daytona sandbox process signal`	Send a signal to a process
`daytona sandbox process wait`	Wait for a process to exit

daytona sandbox process attach

Attach to a process websocket stream

daytona sandbox process attach <sandbox-id> <process-id> [flags]

Flags

Long	Short	Type	Default	Description
`--cursor`		`string`		replay from this cursor before the live stream

daytona sandbox process get

Fetch one process

daytona sandbox process get <sandbox-id> <process-id>

daytona sandbox process kill

Send SIGKILL to a process

daytona sandbox process kill <sandbox-id> <process-id>

daytona sandbox process list

List processes in a sandbox

daytona sandbox process list <sandbox-id> [flags]

Flags

Long	Type	Description
`--kind`	`string`	filter by exec\|pty\|code
`--name`	`string`	filter by live name
`--pid`	`int`	filter by OS pid
`--session-id`	`string`	filter by session id
`--state`	`string`	filter by running\|terminal\|all

daytona sandbox process logs

Read process logs

daytona sandbox process logs <sandbox-id> <process-id> [flags]

Flags

Long	Type	Default	Description
`--cursor`	`string`		resume from this cursor
`--encoding`	`string`	`text`	log encoding: text\|base64
`--follow`	`bool`		follow the log stream with SSE
`--limit`	`int`		max frames to return

daytona sandbox process signal

Send a signal to a process

daytona sandbox process signal <sandbox-id> <process-id> <signal> [flags]

Flags

Long	Short	Type	Default	Description
`--escalate-after`		`string`		escalate after this duration, e.g. 5s
`--escalate-to`		`string`		signal to escalate to, e.g. KILL

daytona sandbox process wait

Wait for a process to exit

daytona sandbox process wait <sandbox-id> <process-id>

daytona sandbox resume

Resume a sandbox

daytona sandbox resume <id>

Examples

daytona sandbox resume <id>

daytona sandbox search

Search sandboxes across the all-region index

The query is optional: filters alone select a set.

daytona sandbox search [query] [flags]

Examples

daytona sandbox search python
daytona sandbox search worker --status running --class linux --region us-west-1
daytona sandbox search --status running
daytona sandbox search 7fJk2mQpXv9dLc3RtY-use1

Flags

Long	Type	Default	Description
`--all`	`bool`		follow every page until exhausted
`--class`	`strings`		filter by class (repeatable or comma-separated)
`--created-after`	`string`		created at or after RFC3339 timestamp
`--created-before`	`string`		created at or before RFC3339 timestamp
`--cursor`	`string`		opaque continuation token
`--forked-from`	`string`		filter by source sandbox id
`--id-prefix`	`string`		filter by sandbox id prefix
`--image-ref`	`string`		filter by exact image reference
`--image-ref-prefix`	`string`		filter by image reference prefix
`--labels`	`string`		filter by labels JSON object
`--last-active-after`	`string`		last activity at or after RFC3339 timestamp
`--last-active-before`	`string`		last activity at or before RFC3339 timestamp
`--limit`	`int`	`100`	max rows to return
`--max-memory`	`int`		maximum memory in MiB
`--max-scratch`	`int`		maximum scratch disk in MiB
`--max-vcpus`	`int`		maximum vCPU count
`--min-memory`	`int`		minimum memory in MiB
`--min-scratch`	`int`		minimum scratch disk in MiB
`--min-vcpus`	`int`		minimum vCPU count
`--name-prefix`	`string`		filter by sandbox name prefix
`--order`	`string`		sort order
`--persistent`	`bool`		filter by persistence
`--sort`	`string`		sort field
`--spot`	`bool`		filter by spot tier
`--status`	`strings`		filter by status (queued\|pending\|assigned\|booting\|running\|pausing\|paused\|stopping\|stopped\|deleting\|deleted\|failed\|lost; repeatable or comma-separated)
`--updated-after`	`string`		updated at or after RFC3339 timestamp
`--updated-before`	`string`		updated at or before RFC3339 timestamp

daytona sandbox ssh

Open SSH through the sandbox gateway

Execs the system ssh binary against the sandbox SSH gateway. Extra SSH flags are forwarded before the destination; any remaining arguments become the remote command.

daytona sandbox ssh <sandbox-id> [ssh-args...] [command]

daytona sandbox start

Start a sandbox

daytona sandbox start <id>

Examples

daytona sandbox start <id>

daytona sandbox stop

Stop a sandbox

daytona sandbox stop <id>

Examples

daytona sandbox stop <id>

daytona sandbox update

Update sandbox labels or lifecycle

daytona sandbox update <id> [flags]

Examples

daytona sandbox update <id> --label env=dev
daytona sandbox update <id> --idle-timeout 600 --on-idle-timeout stop

Flags

Long	Type	Description
`--clear-labels`	`bool`	replace the label set with {}
`--idle-timeout`	`int`	idle seconds until --on-idle-timeout fires (-1 clears the pair)
`--label`	`stringArray`	replacement label KEY=VALUE (repeatable)
`--on-idle-timeout`	`string`	action when --idle-timeout elapses: stop\|pause\|delete
`--on-timeout`	`string`	action when --timeout elapses: stop\|pause\|delete
`--timeout`	`int`	wall-clock seconds until --on-timeout fires (re-anchors the deadline from now)
`--wake-on-request`	`bool`	wake a parked sandbox on traffic

daytona sandbox usage

Read sandbox usage

daytona sandbox usage <id> [flags]

Examples

daytona sandbox usage <id>
daytona sandbox usage <id> --history

Flags

Long	Short	Type	Default	Description
`--history`		`bool`		read usage history

daytona sandbox wait

Wait for a sandbox status

daytona sandbox wait <id> [flags]

Examples

daytona sandbox wait <id> --for running

Flags

Long	Short	Type	Default	Description
`--for`		`string`	`running`	status to wait for

daytona snapshot

Manage snapshots

Examples

daytona snapshot create <sandbox> --name before-upgrade
daytona snapshot list --all

Commands

Command	Description
`daytona snapshot create`	Create a snapshot
`daytona snapshot delete`	Delete a snapshot
`daytona snapshot get`	Get one snapshot
`daytona snapshot list`	List snapshots

daytona snapshot create

Create a snapshot

daytona snapshot create <sandbox> [flags]

Examples

daytona snapshot create <sandbox> --name before-upgrade

Flags

Long	Short	Type	Default	Description
`--name`		`string`		snapshot name

daytona snapshot delete

Delete a snapshot

daytona snapshot delete <id>

Examples

daytona snapshot delete <id> --yes

daytona snapshot get

Get one snapshot

daytona snapshot get <id>

Examples

daytona snapshot get <id>

daytona snapshot list

List snapshots

daytona snapshot list [flags]

Examples

daytona snapshot list --limit 20

Flags

Long	Type	Default	Description
`--all`	`bool`		follow every page until exhausted
`--cursor`	`string`		opaque continuation token
`--limit`	`int`	`100`	max rows to return

daytona volume

Manage volumes

Examples

daytona volume create data --size-gb 200
daytona volume list

Commands

Command	Description
`daytona volume create`	Create a volume
`daytona volume delete`	Delete a volume
`daytona volume get`	Get one volume
`daytona volume list`	List volumes

daytona volume create

Create a volume

daytona volume create <name> [flags]

Examples

daytona volume create data --size-gb 200
daytona volume create data --type bucket
daytona volume create data --type bucket --bucket corp-data --region us-east-1 --access-key-secret AWS_KEY --secret-key-secret AWS_SECRET

Flags

Long	Type	Default	Description
`--access-key-secret`	`string`		project secret name holding the bucket access key
`--bucket`	`string`		customer bucket name; on --type bucket, omitting this creates a platform-owned bucket volume
`--endpoint`	`string`		S3 endpoint URL for a customer bucket
`--path-style`	`bool`		use path-style S3 addressing for a customer bucket
`--prefix`	`string`		bucket prefix
`--region`	`string`		bucket region hint
`--secret-key-secret`	`string`		project secret name holding the bucket secret key
`--size-gb`	`int32`	`100`	volume size in GiB (disk volumes only; bucket volumes let the server reject it with 400)
`--type`	`string`	`disk`	volume type: disk\|bucket

daytona volume delete

Delete a volume

daytona volume delete <id>

Examples

daytona volume delete <id> --yes

daytona volume get

Get one volume

daytona volume get <id>

Examples

daytona volume get <id>

daytona volume list

List volumes

daytona volume list [flags]

Flags

Long	Short	Type	Default	Description
`--include-deleted`		`bool`		include deleted volumes

Sandboxes and resources

On this page

Computersfor Agents