Sandbox Commands

The ve sandbox commands let you list, inspect, connect to, and terminate running sandboxes from the command line. These commands are useful for debugging, monitoring, and managing your sandbox instances.

List Running Sandboxes

Show all sandboxes currently running in your account:

ve sandbox list

Example output:

$ ve sandbox list

  ID           TEMPLATE         STATUS    STARTED          CPU    MEM
  abc123def4   base             running   2 minutes ago    12%    128MB
  xyz789ghi0   custom-python    running   15 minutes ago   3%     256MB
  jkl456mno1   data-science     running   1 hour ago       0%     512MB

  3 sandboxes running

Filter by Template

List only sandboxes using a specific template:

ve sandbox list --template custom-python

$ ve sandbox list --template custom-python

  ID           TEMPLATE         STATUS    STARTED          CPU    MEM
  xyz789ghi0   custom-python    running   15 minutes ago   3%     256MB

  1 sandbox running

Connect to a Sandbox

Open an interactive shell session inside a running sandbox via SSH:

ve sandbox connect <sandbox-id>

$ ve sandbox connect abc123def4
Connecting to sandbox abc123def4...
✓ Connected.

user@sandbox:~$ whoami
user
user@sandbox:~$ ls /home/user
documents  projects  data
user@sandbox:~$ exit
Connection closed.

The connect command establishes an SSH tunnel through the Vibengine API. You do not need to configure SSH keys or open any ports.

Create and Connect to a Sandbox

Create a sandbox from a template and immediately connect your terminal to it:

ve sandbox create [template]

Options

Option	Description
`[template]`	Template ID to create the sandbox from
`--path <path>`	Project path used to discover sandbox config
`--config <path>`	Explicit path to sandbox config file

If [template] is omitted, the CLI tries to load template_id from your sandbox config.

Example output:

$ ve sandbox create mfwx22g9oj4qjjssorod
Terminal connecting to template mfwx22g9oj4qjjssorod with sandbox ID itul0qx65py5ltscc8i2m

root@sandbox:/# whoami
root
root@sandbox:/# exit
Closing terminal connection to template mfwx22g9oj4qjjssorod with sandbox ID itul0qx65py5ltscc8i2m

This command keeps the sandbox alive while connected and closes the sandbox when you exit the terminal session.

Execute a Command in a Sandbox

Run a command inside an already running sandbox:

ve sandbox exec <sandbox-id> <command...>

Options

Option	Description
`<sandbox-id>`	Target sandbox ID
`<command...>`	Command (and arguments) to execute
`-b, --background`	Run command in background and return immediately
`-c, --cwd <dir>`	Working directory inside sandbox
`-u, --user <user>`	Run command as specified user
`-e, --env <KEY=VALUE>`	Set environment variable (repeatable)

Example (foreground):

ve sandbox exec itul0qx65py5ltscc8i2m python --version

$ ve sandbox exec itul0qx65py5ltscc8i2m python --version
Python 3.12.8

Example (background):

ve sandbox exec itul0qx65py5ltscc8i2m --background sleep 300

$ ve sandbox exec itul0qx65py5ltscc8i2m --background sleep 300
12345

Stdin piping is not supported for ve sandbox exec (for example: echo "data" | ve sandbox exec ...).

View Sandbox Logs

Retrieve logs from a running or recently terminated sandbox:

ve sandbox logs <sandbox-id>

$ ve sandbox logs abc123def4

[2026-02-21T10:30:01Z] Sandbox started (template: base)
[2026-02-21T10:30:02Z] Kernel ready
[2026-02-21T10:30:05Z] Execution: print("hello") -> completed (42ms)
[2026-02-21T10:32:15Z] Execution: import pandas as pd -> completed (1.2s)
[2026-02-21T10:32:20Z] Execution: df.describe() -> completed (89ms)

Follow Logs in Real-Time

Use the --follow flag to stream logs as they happen:

ve sandbox logs <sandbox-id> --follow

Press Ctrl+C to stop following.

Limit Log Output

Show only the last N lines:

ve sandbox logs <sandbox-id> --tail 20

Kill a Sandbox

Terminate a running sandbox immediately:

ve sandbox kill <sandbox-id>

$ ve sandbox kill abc123def4
✓ Sandbox abc123def4 terminated.

Kill Multiple Sandboxes

Terminate several sandboxes at once:

ve sandbox kill abc123def4 xyz789ghi0

$ ve sandbox kill abc123def4 xyz789ghi0
✓ Sandbox abc123def4 terminated.
✓ Sandbox xyz789ghi0 terminated.

Kill All Running Sandboxes

This terminates every running sandbox in your account. Use with caution.

ve sandbox kill --all

$ ve sandbox kill --all
This will terminate all 3 running sandboxes. Continue? (y/N) y
✓ Sandbox abc123def4 terminated.
✓ Sandbox xyz789ghi0 terminated.
✓ Sandbox jkl456mno1 terminated.
All sandboxes terminated.

Sandbox Info

Get detailed information about a specific sandbox:

ve sandbox info <sandbox-id>

$ ve sandbox info abc123def4

  ID:         abc123def4
  Template:   base
  Status:     running
  Started:    2026-02-21T10:30:01Z (5 minutes ago)
  CPU:        12%
  Memory:     128MB / 512MB
  Timeout:    300s remaining
  Metadata:   {"user_id": "usr_123", "session": "demo"}

Command Reference

Command	Description
`ve sandbox connect <id>`	SSH into a running sandbox
`ve sandbox create [template]`	Create a sandbox and connect your terminal
`ve sandbox exec <id> <command...>`	Execute a command in a running sandbox
`ve sandbox info <id>`	Show detailed sandbox info
`ve sandbox kill <id>`	Terminate a sandbox
`ve sandbox kill --all`	Terminate all sandboxes
`ve sandbox list`	List all running sandboxes
`ve sandbox list --template <name>`	Filter sandboxes by template
`ve sandbox logs <id>`	View sandbox logs
`ve sandbox logs <id> --follow`	Stream logs in real-time

Sandbox Commands

On this page