# create

## Usage

```bash
bdy sandbox create|add [options]
```

## Options

| **Option** | **Description** |
| :--- | :--- |
| `-w, --workspace <domain>` | Workspace URL handle. Can be set via variable: BUDDY_WORKSPACE |
| `-p, --project <name>` | Project name. Can be set via variable: BUDDY_PROJECT |
| `-n, --name <name>` | Sandbox display name |
| `-i, --identifier <identifier>` | Sandbox identifier |
| `--os <image>` | Operating system image (default: ubuntu:24.04) |
| `--snapshot <snapshot-name>` | Create from snapshot name (instead of OS) |
| `--resources <spec>` | Resource allocation: 1x2, 2x4, 4x8, 8x16, 12x24 (CPUxRAM) |
| `--boot-command <commands...>` | Setup commands to run on creation (can be used multiple times) |
| `--app-command <commands...>` | Application command to run at startup (can be used multiple times) |
| `--app-dir <directory>` | Application directory of the sandbox |
| `--tag <tags...>` | Tags to add on creation (can be used multiple times) |
| `--timeout <seconds>` | The timeout in seconds after which the sandbox will be automatically stopped |
| `--yaml <content|@path>` | Complete sandbox YAML. To specify file use @path/to/file format in value |
| `--wait-for-running [seconds]` | Wait until sandbox is running |
| `--wait-for-configured [seconds]` | Wait until sandbox ran setup commands |
| `--wait-for-apps [seconds]` | Wait until sandbox apps are running |
| `-h, --help` | display help for command |

## Examples

### Create ubuntu 22.04 sandbox with name and wait for start

```bash
bdy sb create -n "name" --os ubuntu:22.04  --wait-for-running
```

### Create sandbox with identifier, run install commands and wait for start & commands to complete

```bash
bdy sb create -i "test" --install-command "apt-get update && apt-get install curl -y" --wait-for-configure
```

### Create sandbox with custom resources and tag it

```bash
bdy sb create --resources 4x8 --tag "tag1" --tag "tag2
```

### Create sandbox from yaml file

```bash
bdy sb create --yaml @./test.yml"
```


---
Original source: https://buddy.works/docs/cli/sandbox/create