bdy sandbox create

View as Markdown

$bdy sandbox create|add [options]

Create a new sandbox

OPTIONS

-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

Documentation for bdy v1.20.0

Last modified on Apr 13, 2026

cp destroy

Examples

Create ubuntu 22.04 sandbox with name and wait for start
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
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
bdy sb create --resources 4x8 --tag "tag1" --tag "tag2$

Create sandbox from yaml file
bdy sb create --yaml @./test.yml"$