# CLI

Daytona provides command-line access to core features for interacting with Daytona Sandboxes, including managing their lifecycle, snapshots, and more.

The CLI reference lists all commands supported by the `daytona` command-line tool, complete with a description of their behavior, and any supported flags. You can access this documentation on a per-command basis by appending the `--help`/`-h` flag when invoking `daytona`.

## Installation

Install the Daytona CLI to interact with Daytona sandboxes from the command line.

- [Mac](/content/docs/en/tools/cli/#tab-panel-1767/index.html)
- [Linux](/content/docs/en/tools/cli/#tab-panel-1768/index.html)
- [Windows](/content/docs/en/tools/cli/#tab-panel-1769/index.html)

```
brew install daytonaio/cli/daytona
```

Trust the tap once so routine `brew upgrade` keeps the Daytona CLI up to date. Recent Homebrew versions require third-party taps to be explicitly trusted; without it, a bare `brew upgrade` skips the Daytona tap and the CLI goes stale:

```
brew trust daytonaio/cli
```

To upgrade the Daytona CLI to the latest version:

```
brew upgrade daytonaio/cli/daytona
```

Alternatively, install directly without Homebrew:

For Apple Silicon (`arm64`):

```
sudo curl -fL https://github.com/daytonaio/daytona/releases/latest/download/daytona-darwin-arm64 -o /usr/local/bin/daytona && sudo chmod +x /usr/local/bin/daytona
```

For Intel (`amd64`):

```
sudo curl -fL https://github.com/daytonaio/daytona/releases/latest/download/daytona-darwin-amd64 -o /usr/local/bin/daytona && sudo chmod +x /usr/local/bin/daytona
```

Choose the command for your Linux architecture. Both commands download the latest binary from GitHub releases and install it to `/usr/local/bin`, overwriting any existing version.

For `amd64` (`x86_64`):

```
sudo curl -fL https://github.com/daytonaio/daytona/releases/latest/download/daytona-linux-amd64 -o /usr/local/bin/daytona && sudo chmod +x /usr/local/bin/daytona
```

For `arm64` (`aarch64`):

```
sudo curl -fL https://github.com/daytonaio/daytona/releases/latest/download/daytona-linux-arm64 -o /usr/local/bin/daytona && sudo chmod +x /usr/local/bin/daytona
```

```
powershell -Command "irm https://get.daytona.io/windows | iex"
```

After installing the Daytona CLI, use the `daytona` command to interact with Daytona sandboxes from the command line.

## daytona

### Command

```
daytona [flags]
```

### Flags

| Long        | Short | Description                          |
| :--------- | :---- | :---------------------------------- |
| `--help`   |       | help for daytona                   |
| `--version`| `-v`  | Display the version of Daytona      |

## daytona archive

### Command

```
daytona archive [SANDBOX_ID] | [SANDBOX_NAME] [flags]
```

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--help` |       | help for daytona                   |

## daytona autocomplete

### Command

```
daytona autocomplete [bash|zsh|fish|powershell] [flags]
```

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--help` |       | help for daytona                   |

## daytona create

### Command

```
daytona create [flags]
```

### Flags

| Long                  | Short | Description                                                                       |
| :------------------- | :---- | :------------------------------------------------------------------------------- |
| `--auto-archive`     |       | Auto-archive interval in minutes (0 means the maximum interval will be used)     |
| `--auto-delete`      |       | Auto-delete interval in minutes (negative value means disabled)                  |
| `--auto-pause`       |       | Auto-pause interval in minutes (0 means disabled)                                |
| `--auto-stop`        |       | Auto-stop interval in minutes (0 means disabled)                                 |
| `--context`          | `-c`  | Files or directories to include in the build context (can be specified multiple times) |
| `--cpu`              |       | CPU cores allocated to the sandbox                                               |
| `--disk`             |       | Disk space allocated to the sandbox in GB                                        |
| `--dockerfile`       | `-f`  | Path to Dockerfile for Sandbox snapshot                                         |
| `--env`              | `-e`  | Environment variables (format: KEY=VALUE)                                       |
| `--gpu`              |       | GPU units allocated to the sandbox                                               |
| `--kvm`              |       | Expose KVM (/dev/kvm) inside the sandbox via nested virtualization               |
| `--label`            | `-l`  | Labels (format: KEY=VALUE)                                                      |
| `--memory`           |       | Memory allocated to the sandbox in MB                                            |
| `--name`             |       | Name of the sandbox                                                              |
| `--network-allow-list` |     | Comma-separated list of allowed CIDR network addresses for the sandbox           |
| `--network-block-all`  |     | Whether to block all network access for the sandbox                               |
| `--public`            |       | Make sandbox publicly accessible                                                 |
| `--queue-timeout`     |      | Minutes to wait for runner assignment before the sandbox creation is cancelled    |
| `--snapshot`          |       | Snapshot to use for the sandbox                                                  |
| `--target`            |       | Target region (eu, us)                                                          |
| `--ttl`               |       | Maximum time to live in minutes                                                  |
| `--user`              |       | User associated with the sandbox                                                 |
| `--volume`           | `-v`  | Volumes to mount (format: VOLUME_ID_OR_NAME:MOUNT_PATH)                        |
| `--help`             |       | help for daytona                                                                |

## daytona delete

### Command

```
daytona delete [SANDBOX_ID] | [SANDBOX_NAME] [flags]
```

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--all`  | `-a`  | Delete all sandboxes                 |
| `--help` |       | help for daytona                   |

## daytona docs

### Command

```
daytona docs [flags]
```

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--help` |       | help for daytona                   |

## daytona exec

### Command

```
daytona exec [SANDBOX_ID | SANDBOX_NAME] -- [COMMAND] [ARGS...] [flags]
```

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--cwd` |       | Working directory for command execution |
| `--timeout` |   | Command timeout in seconds (0 for no timeout) | 
| `--help` |       | help for daytona                   |

## daytona info

### Command

```
daytona info [SANDBOX_ID] | [SANDBOX_NAME] [flags]
```

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--format` | `-f`  | Output format. Must be one of (yaml, json) |
| `--help` |       | help for daytona                   |

## daytona list

### Command

```
daytona list [flags]
```

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--cursor` | `-c`  | Cursor for pagination               |
| `--format` | `-f`  | Output format. Must be one of (yaml, json) |
| `--limit` | `-l`  | Maximum number of items per page    |
| `--help` |       | help for daytona                   |

## daytona login

### Command

```
daytona login [flags]
```

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--api-key` |       | API key to use for authentication   |
| `--help` |       | help for daytona                   |

## daytona logout

### Command

```
daytona logout [flags]
```

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--help` |       | help for daytona                   |

## daytona mcp

### Command

```
daytona mcp [flags]
```

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--help` |       | help for daytona                   |

## daytona mcp config

### Command

```
daytona mcp config [AGENT_NAME] [flags]
```

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--help` |       | help for daytona                   |

## daytona mcp init

### Command

```
daytona mcp init [AGENT_NAME] [flags]
```

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--help` |       | help for daytona                   |

## daytona mcp start

### Command

```
daytona mcp start [flags]
```

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--help` |       | help for daytona                   |

## daytona organization

### Command

```
daytona organization [flags]
```

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--help` |       | help for daytona                   |

## daytona organization create

### Command

```
daytona organization create [ORGANIZATION_NAME] [flags]
```

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--region` | `-r`  | Default region (id or name) for the organization |
| `--help` |       | help for daytona                   |

## daytona organization delete

### Command

```
daytona organization delete [ORGANIZATION] [flags]
```

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--help` |       | help for daytona                   |

## daytona organization list

### Command

```
daytona organization list [flags]
```

### Flags

## daytona organization members

### Command

```
daytona organization members [ORGANIZATION] [flags]
```

### Flags

## daytona organization use

### Command

```
daytona organization use [ORGANIZATION] [flags]
```

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--help` |       | help for daytona                   |

## daytona pause

### Command

```
daytona pause [SANDBOX_ID] | [SANDBOX_NAME] [flags]
```

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--help` |       | help for daytona                   |

## daytona preview-url

### Command

```
daytona preview-url [SANDBOX_ID | SANDBOX_NAME] [flags]
```

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--expires` |      | URL expiration time in seconds      |
| `--port` | `-p`  | Port number to get preview URL for (required) |
| `--help` |       | help for daytona                   |

## daytona snapshot

### Command

```
daytona snapshot [flags]
```

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--help` |       | help for daytona                   |

## daytona snapshot activate

### Command

```
daytona snapshot activate [SNAPSHOT_ID | SNAPSHOT_NAME] [flags]
```

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--help` |       | help for daytona                   |

## daytona snapshot create

### Command

```
daytona snapshot create [SNAPSHOT] [flags]
```

### Flags

| Long                  | Short | Description                                                                       |
| :------------------- | :---- | :------------------------------------------------------------------------------- |
| `--context`          | `-c`  | Files or directories to include in the build context (can be specified multiple times). If not provided, context will be automatically determined from COPY/ADD commands in the Dockerfile |
| `--cpu`              |       | CPU cores that will be allocated to the underlying sandboxes (default: 1)       |
| `--disk`             |       | Disk space that will be allocated to the underlying sandboxes in GB (default: 3) |
| `--dockerfile`       | `-f`  | Path to Dockerfile to build                                                     |
| `--entrypoint`       | `-e`  | The entrypoint command for the snapshot                                         |
| `--image`            | `-i`  | The image name for the snapshot                                                  |
| `--memory`           |       | Memory that will be allocated to the underlying sandboxes in GB (default: 1)  |
| `--region`           |       | ID of the region where the snapshot will be available (defaults to organization default region) |
| `--sandbox-class`    |       | Target sandbox class for the snapshot. One of: ‘container’ or ‘linux-vm’ |
| `--help`             |       | help for daytona                                                                |

## daytona snapshot delete

### Command

```
daytona snapshot delete [SNAPSHOT_ID | SNAPSHOT_NAME] [flags]
```

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--all`  | `-a`  | Delete all snapshots                  |
| `--help` |       | help for daytona                   |

## daytona snapshot list

### Command

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

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--format` | `-f`  | Output format. Must be one of (yaml, json) |
| `--limit` | `-l`  | Maximum number of items per page     |
| `--page`  | `-p`  | Page number for pagination (starting from 1) |
| `--source-sandbox-id` |      | Filter by the ID of the sandbox the snapshot was created from |
| `--help` |       | help for daytona                   |

## daytona snapshot push

### Command

```
daytona snapshot push [SNAPSHOT] [flags]
```

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--cpu`  |       | CPU cores that will be allocated to the underlying sandboxes (default: 1) |
| `--disk` |       | Disk space that will be allocated to the underlying sandboxes in GB (default: 3) |
| `--entrypoint` | `-e`  | The entrypoint command for the image |
| `--memory` |       | Memory that will be allocated to the underlying sandboxes in GB (default: 1) |
| `--name` | `-n`  | Specify the Snapshot name            |
| `--region` |       | ID of the region where the snapshot will be available (defaults to organization default region) |
| `--help` |       | help for daytona                   |

## daytona ssh

### Command

```
daytona ssh [SANDBOX_ID] | [SANDBOX_NAME] [flags]
```

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--expires` |      | SSH access token expiration time in minutes |
| `--help` |       | help for daytona                   |

## daytona start

### Command

```
daytona start [SANDBOX_ID] | [SANDBOX_NAME] [flags]
```

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--help` |       | help for daytona                   |

## daytona stop

### Command

```
daytona stop [SANDBOX_ID] | [SANDBOX_NAME] [flags]
```

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--force` | `-f`  | Force stop the sandbox using SIGKILL |
| `--help` |       | help for daytona                   |

## daytona version

### Command

```
daytona version [flags]
```

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--help` |       | help for daytona                   |

## daytona volume

### Command

```
daytona volume [flags]
```

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--help` |       | help for daytona                   |

## daytona volume create

### Command

```
daytona volume create [NAME] [flags]
```

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--size` | `-s` | Size of the volume in GB            |
| `--help` |       | help for daytona                   |

## daytona volume delete

### Command

```
daytona volume delete [VOLUME_ID_OR_NAME] [flags]
```

### Flags

| Long      | Short | Description                          |
| :------- | :---- | :---------------------------------- |
| `--help` |       | help for daytona                   |

## daytona volume get

### Command

```
daytona volume get [VOLUME_ID_OR_NAME] [flags]
```

### Flags

## daytona volume list

### Command

```
daytona volume list [flags]
```

### Flags
