Sandboxes and resources

Daytona v2

Documentation for Daytona v2, currently in alpha. For the latest release, see Daytona v0.

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 image	Manage images
daytona mac-model	Inspect the Mac model catalog
daytona region	Inspect regions
daytona reservation	Reserve dedicated Macs for macOS sandboxes
daytona sandbox	Create and operate sandboxes
daytona snapshot	Manage snapshots

daytona cpu-type

Inspect the CPU type catalog

Commands

Command	Description
daytona cpu-type list	List CPU types

daytona cpu-type list

List CPU types

List CPU types from the CPU catalog.

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 image

Manage images

Examples

daytona image list --all

Commands

Command	Description
daytona image build	Build an image from a Dockerfile context
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 capture

Capture a sandbox filesystem as an image

Capture only a sandbox disk as an image. Linux images have kind disk; Windows images have kind block. For memory capture, use daytona snapshot create. A macOS sandbox must be persistent and stopped; it cannot start until the snapshot is ready.

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

—platform true lists the platform images every project can boot; —platform any adds them to the project’s own.

daytona image list [flags]

Examples

daytona image list --limit 20
daytona image list --platform true

Flags

Long	Short	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
--platform		string		platform images: true (only platform images)|false (only the project’s, the default)|any (both)
--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 mac-model

Inspect the Mac model catalog

Commands

Command	Description
daytona mac-model list	List registered Mac models

daytona mac-model list

List registered Mac models

With —region, also show how many Macs of each model a purchase can reserve now (AVAILABLE) and the price of one Mac-hour and one 24-hour period.

daytona mac-model list [flags]

Examples

daytona mac-model list
daytona mac-model list --region macos-1

Flags

Long	Short	Type	Default	Description
--region		R		region slug: also show free Macs and prices from GET /mac-catalog

daytona region

Inspect regions

Commands

Command	Description
daytona region list	List regions

daytona region list

List regions

List your regions at every level, parents before their children. AVAILABLE says whether a create can name the region.

daytona region list

Examples

daytona region list

daytona reservation

Reserve dedicated Macs for macOS sandboxes

A reservation is one named Mac model, paid per 24-hour period.

Examples

daytona mac-model list
daytona reservation create --region macos-1 --model m4pro-12c-24g --idempotency-key nightly-mac
daytona reservation create --region macos-1 --count 3
daytona reservation get RESERVATION_ID
daytona reservation list
daytona reservation renew RESERVATION_ID
daytona reservation update RESERVATION_ID --auto-renew=false

Commands

Command	Description
daytona reservation create	Reserve a Mac
daytona reservation get	Get one Mac reservation
daytona reservation list	List Mac reservations
daytona reservation renew	Renew a Mac reservation for another period
daytona reservation update	Turn a Mac reservation’s auto-renew on or off

daytona reservation create

Reserve a Mac

Reserve a Mac of one model in a region (POST /reservations). The SDK twin is reservations.create(…). With —count, reserve several Macs of one model in one request (POST /reservations/bulk). The SDK twin is reservations.createBulk(…). Without —model the region’s default model is reserved; an unavailable model is never upgraded to another one. Without —idempotency-key the CLI sends a fresh key; pass your own to retry without buying a second Mac.

daytona reservation create [flags]

Examples

daytona reservation create --region macos-1 --model m4pro-12c-24g --idempotency-key nightly-mac
daytona reservation create --region macos-1 --model m4pro-12c-24g --count 3 --idempotency-key nightly-macs
daytona reservation create --region macos-1 --count 5 --min-count 2
daytona reservation create --region macos-1 --model m4-10c-16g --count 3 --dry-run

Flags

Long	Short	Type	Default	Description
--auto-renew		bool		renew while a sandbox is active; create-macos requires —reservation new
--count		N		how many Macs to reserve, 1 to 100 (calls POST /reservations/bulk; default: one Mac through POST /reservations)
--dry-run		bool		print the price and the free Macs from GET /mac-catalog and reserve nothing
--idempotency-key		KEY		a retry with the same key returns the first reservation instead of buying another (default: a fresh key per invocation)
--layout		split|whole		split runs up to two sandboxes on each Mac, whole runs one (default: the model’s default layout)
--min-count		M		the fewest Macs to accept when fewer than —count are free (default: —count, all or nothing)
--model		MODEL		Mac model slug from mac-model list (default: the region’s default model; no upgrade)

daytona reservation get

Get one Mac reservation

Get one Mac reservation (GET /reservations/{id}).

daytona reservation get ID

Examples

daytona reservation get RESERVATION_ID

daytona reservation list

List Mac reservations

List the organization’s Mac reservations, newest first: open ones and those ended in the last 30 days (GET /reservations).

daytona reservation list

Examples

daytona reservation list

daytona reservation renew

Renew a Mac reservation for another period

Charge the next period of an active reservation (POST /reservations/{id}/renew); period_end moves out by one period on the same Mac. The SDK twin is reservations.renew(…). Without —idempotency-key the CLI sends a fresh key; pass your own to retry without paying for a second period.

daytona reservation renew ID [flags]

Examples

daytona reservation renew RESERVATION_ID --idempotency-key renew-RESERVATION_ID-2

Flags

Long	Short	Type	Default	Description
--idempotency-key		KEY		a retry with the same key returns the reservation without charging another period (default: a fresh key per invocation)

daytona reservation update

Turn a Mac reservation’s auto-renew on or off

Turn auto-renew on or off (PATCH /reservations/{id}). An auto-renewing reservation renews near period_end only while a sandbox is in use on it; stopped and paused sandboxes do not renew it. With auto-renew off, the reservation ends at period_end.

daytona reservation update ID [flags]

Examples

daytona reservation update RESERVATION_ID --auto-renew=false
daytona reservation update RESERVATION_ID --auto-renew=true

Flags

Long	Short	Type	Default	Description
--auto-renew		bool		renew near period_end while a sandbox is in use on the reservation; false lets it end at period_end

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 from a 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], …). Without —image the sandbox boots the platform default image.

daytona sandbox create [flags]

Examples

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

Flags

Long	Short	Type	Default	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 (default: the platform default image)
--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
--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
--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 from a snapshot

Create a Linux sandbox from a snapshot (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	Short	Type	Default	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	Short	Type	Default	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	Short	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	Short	Type	Default	Description
--kind		string		filter by exec|pty|code|session
--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	Short	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	Short	Type	Default	Description
--all		bool		follow every page until exhausted
--class		strings		filter by class (repeatable or comma-separated)
--created-end-at		string		exclusive creation-time upper bound (RFC3339)
--created-start-at		string		inclusive creation-time lower bound (RFC3339)
--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-activity-end-at		string		exclusive activity-time upper bound (RFC3339)
--last-activity-start-at		string		inclusive activity-time lower bound (RFC3339)
--limit		int	100	max rows to return
--max-disk		int		maximum disk in MiB
--max-memory		int		maximum memory in MiB
--max-vcpus		int		maximum vCPU count
--min-disk		int		minimum disk in MiB
--min-memory		int		minimum memory in MiB
--min-vcpus		int		minimum vCPU count
--name-prefix		string		filter by sandbox name prefix
--order		string		sort order
--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-end-at		string		exclusive update-time upper bound (RFC3339)
--updated-start-at		string		inclusive update-time lower bound (RFC3339)

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	Short	Type	Default	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

Create a memory snapshot. Linux creates a full snapshot with memory and disk; GPU creates a checkpoint; Windows and macOS are unsupported. For disk-only capture, use daytona image capture.

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	Short	Type	Default	Description
--all		bool		follow every page until exhausted
--cursor		string		opaque continuation token
--limit		int	100	max rows to return