# Sandboxes and resources

{/* This file was generated by tools/v2/generate-cli-docs from the daytona CLI source. Do not edit this file directly; run yarn update-v2-cli-reference. */}

## Commands

This page documents the following commands. Global flags that apply to every command are listed under [`daytona`](https://www.daytona.io/docs/en/v2/cli.md#daytona).

| Command | Description |
| :------ | :---------- |
| [`daytona cpu-type`](#daytona-cpu-type) | Inspect the CPU type catalog |
| [`daytona image`](#daytona-image) | Manage images |
| [`daytona mac-model`](#daytona-mac-model) | Inspect the Mac model catalog |
| [`daytona region`](#daytona-region) | Inspect regions |
| [`daytona reservation`](#daytona-reservation) | Reserve dedicated Macs for macOS sandboxes |
| [`daytona sandbox`](#daytona-sandbox) | Create and operate sandboxes |
| [`daytona snapshot`](#daytona-snapshot) | Manage snapshots |

## daytona cpu-type

Inspect the CPU type catalog

__Commands__

| Command | Description |
| :------ | :---------- |
| [`daytona cpu-type list`](#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.

```shell
daytona cpu-type list [flags]
```

__Examples__

```shell
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__

```shell
daytona image list --all
```

__Commands__

| Command | Description |
| :------ | :---------- |
| [`daytona image build`](#daytona-image-build) | Build an image from a Dockerfile context |
| [`daytona image capture`](#daytona-image-capture) | Capture a sandbox filesystem as an image |
| [`daytona image create`](#daytona-image-create) | Import an image from a registry ref |
| [`daytona image delete`](#daytona-image-delete) | Delete an image |
| [`daytona image get`](#daytona-image-get) | Get one image |
| [`daytona image list`](#daytona-image-list) | List images |
| [`daytona image logs`](#daytona-image-logs) | Read image build logs |
| [`daytona image promote`](#daytona-image-promote) | Name an anonymous image, making it permanent |

### daytona image build

Build an image from a Dockerfile context

```shell
daytona image build <name> [flags]
```

__Examples__

```shell
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`.

```shell
daytona image capture <sandbox> [flags]
```

__Examples__

```shell
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

```shell
daytona image create <name> [flags]
```

__Aliases:__ `import`

__Examples__

```shell
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

```shell
daytona image delete <id>
```

__Examples__

```shell
daytona image delete <id> --yes
```

### daytona image get

Get one image

```shell
daytona image get <id>
```

__Examples__

```shell
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.

```shell
daytona image list [flags]
```

__Examples__

```shell
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

```shell
daytona image logs <id> [flags]
```

__Examples__

```shell
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.

```shell
daytona image promote <image> <name>
```

__Examples__

```shell
daytona image promote img_abc123 saved-image
```

## daytona mac-model

Inspect the Mac model catalog

__Commands__

| Command | Description |
| :------ | :---------- |
| [`daytona mac-model list`](#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.

```shell
daytona mac-model list [flags]
```

__Examples__

```shell
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`](#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.

```shell
daytona region list
```

__Examples__

```shell
daytona region list
```

## daytona reservation

Reserve dedicated Macs for macOS sandboxes

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

__Examples__

```shell
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`](#daytona-reservation-create) | Reserve a Mac |
| [`daytona reservation get`](#daytona-reservation-get) | Get one Mac reservation |
| [`daytona reservation list`](#daytona-reservation-list) | List Mac reservations |
| [`daytona reservation renew`](#daytona-reservation-renew) | Renew a Mac reservation for another period |
| [`daytona reservation update`](#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.

```shell
daytona reservation create [flags]
```

__Examples__

```shell
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\}).

```shell
daytona reservation get ID
```

__Examples__

```shell
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).

```shell
daytona reservation list
```

__Examples__

```shell
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.

```shell
daytona reservation renew ID [flags]
```

__Examples__

```shell
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.

```shell
daytona reservation update ID [flags]
```

__Examples__

```shell
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`](#daytona-sandbox-cp) | Copy files to or from a sandbox |
| [`daytona sandbox create`](#daytona-sandbox-create) | Create a sandbox from an image |
| [`daytona sandbox create-from-snapshot`](#daytona-sandbox-create-from-snapshot) | Create a sandbox from a snapshot |
| [`daytona sandbox delete`](#daytona-sandbox-delete) | Delete a sandbox |
| [`daytona sandbox docker`](#daytona-sandbox-docker) | Inspect Docker Engine inside a sandbox |
| [`daytona sandbox exec`](#daytona-sandbox-exec) | Run a command inside a sandbox |
| [`daytona sandbox fork`](#daytona-sandbox-fork) | Fork a sandbox |
| [`daytona sandbox get`](#daytona-sandbox-get) | Get one sandbox |
| [`daytona sandbox list`](#daytona-sandbox-list) | List sandboxes |
| [`daytona sandbox logs`](#daytona-sandbox-logs) | Read sandbox logs |
| [`daytona sandbox pause`](#daytona-sandbox-pause) | Pause a sandbox |
| [`daytona sandbox port`](#daytona-sandbox-port) | Inspect sandbox ports |
| [`daytona sandbox preview-url`](#daytona-sandbox-preview-url) | Mint a preview URL |
| [`daytona sandbox process`](#daytona-sandbox-process) | Inspect and control sandbox processes |
| [`daytona sandbox resume`](#daytona-sandbox-resume) | Resume a sandbox |
| [`daytona sandbox search`](#daytona-sandbox-search) | Search sandboxes across the all-region index |
| [`daytona sandbox ssh`](#daytona-sandbox-ssh) | Open SSH through the sandbox gateway |
| [`daytona sandbox start`](#daytona-sandbox-start) | Start a sandbox |
| [`daytona sandbox stop`](#daytona-sandbox-stop) | Stop a sandbox |
| [`daytona sandbox update`](#daytona-sandbox-update) | Update sandbox labels or lifecycle |
| [`daytona sandbox usage`](#daytona-sandbox-usage) | Read sandbox usage |
| [`daytona sandbox wait`](#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.

```shell
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.

```shell
daytona sandbox create [flags]
```

__Examples__

```shell
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.

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

__Examples__

```shell
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

```shell
daytona sandbox delete <id>
```

__Examples__

```shell
daytona sandbox delete <id>
```

### daytona sandbox docker

Inspect Docker Engine inside a sandbox

__Examples__

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

__Commands__

| Command | Description |
| :------ | :---------- |
| [`daytona sandbox docker status`](#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.

```shell
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.

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

__Examples__

```shell
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

```shell
daytona sandbox fork <id> [flags]
```

__Examples__

```shell
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.

```shell
daytona sandbox get <id>
```

__Examples__

```shell
daytona sandbox get <id>
```

### daytona sandbox list

List sandboxes

List sandboxes across regions.

```shell
daytona sandbox list [flags]
```

__Examples__

```shell
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

```shell
daytona sandbox logs <id> [flags]
```

__Examples__

```shell
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

```shell
daytona sandbox pause <id>
```

__Examples__

```shell
daytona sandbox pause <id>
```

### daytona sandbox port

Inspect sandbox ports

__Commands__

| Command | Description |
| :------ | :---------- |
| [`daytona sandbox port list`](#daytona-sandbox-port-list) | List listening ports inside a sandbox |

### daytona sandbox port list

List listening ports inside a sandbox

```shell
daytona sandbox port list <sandbox-id>
```

### daytona sandbox preview-url

Mint a preview URL

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

__Examples__

```shell
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`](#daytona-sandbox-preview-url-expire) | Expire one signed preview URL |

### daytona sandbox preview-url expire

Expire one signed preview URL

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

__Examples__

```shell
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`](#daytona-sandbox-process-attach) | Attach to a process websocket stream |
| [`daytona sandbox process get`](#daytona-sandbox-process-get) | Fetch one process |
| [`daytona sandbox process kill`](#daytona-sandbox-process-kill) | Send SIGKILL to a process |
| [`daytona sandbox process list`](#daytona-sandbox-process-list) | List processes in a sandbox |
| [`daytona sandbox process logs`](#daytona-sandbox-process-logs) | Read process logs |
| [`daytona sandbox process signal`](#daytona-sandbox-process-signal) | Send a signal to a process |
| [`daytona sandbox process wait`](#daytona-sandbox-process-wait) | Wait for a process to exit |

### daytona sandbox process attach

Attach to a process websocket stream

```shell
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

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

### daytona sandbox process kill

Send SIGKILL to a process

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

### daytona sandbox process list

List processes in a sandbox

```shell
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

```shell
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

```shell
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

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

### daytona sandbox resume

Resume a sandbox

```shell
daytona sandbox resume <id>
```

__Examples__

```shell
daytona sandbox resume <id>
```

### daytona sandbox search

Search sandboxes across the all-region index

The query is optional: filters alone select a set.

```shell
daytona sandbox search [query] [flags]
```

__Examples__

```shell
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.

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

### daytona sandbox start

Start a sandbox

```shell
daytona sandbox start <id>
```

__Examples__

```shell
daytona sandbox start <id>
```

### daytona sandbox stop

Stop a sandbox

```shell
daytona sandbox stop <id>
```

__Examples__

```shell
daytona sandbox stop <id>
```

### daytona sandbox update

Update sandbox labels or lifecycle

```shell
daytona sandbox update <id> [flags]
```

__Examples__

```shell
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

```shell
daytona sandbox usage <id> [flags]
```

__Examples__

```shell
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

```shell
daytona sandbox wait <id> [flags]
```

__Examples__

```shell
daytona sandbox wait <id> --for running
```

__Flags__

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

## daytona snapshot

Manage snapshots

__Examples__

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

__Commands__

| Command | Description |
| :------ | :---------- |
| [`daytona snapshot create`](#daytona-snapshot-create) | Create a snapshot |
| [`daytona snapshot delete`](#daytona-snapshot-delete) | Delete a snapshot |
| [`daytona snapshot get`](#daytona-snapshot-get) | Get one snapshot |
| [`daytona snapshot list`](#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`.

```shell
daytona snapshot create <sandbox> [flags]
```

__Examples__

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

__Flags__

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

### daytona snapshot delete

Delete a snapshot

```shell
daytona snapshot delete <id>
```

__Examples__

```shell
daytona snapshot delete <id> --yes
```

### daytona snapshot get

Get one snapshot

```shell
daytona snapshot get <id>
```

__Examples__

```shell
daytona snapshot get <id>
```

### daytona snapshot list

List snapshots

```shell
daytona snapshot list [flags]
```

__Examples__

```shell
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 |