Creating a Sandbox
oc create (shortcut for oc sandbox create) provisions a new sandbox VM:bash
12oc create oc create --timeout 600 --cpu 2 --memory 2048 --env NODE_ENV=production
The sandbox ID is printed on success. Use
--json to capture it programmatically:bash
1ID=$(oc create --json | jq -r '.sandboxID')
Ask AI about this page
Listing & Inspecting
bash
12345# List all sandboxes oc ls # Detailed info for a specific sandbox oc sandbox get sb-abc123
oc ls shows a table with ID, template, status, CPU, memory, and age. Add --json for machine-readable output.Hibernation & Wake
Save state and stop paying for compute. Wake resumes the same sandbox — the platform attempts fast snapshot restore with a cold-boot fallback if needed.
bash
12345oc sandbox hibernate sb-abc123 # ... hours later ... oc sandbox wake sb-abc123 oc shell sb-abc123
The sandbox keeps the same ID across hibernate/wake cycles. Preview URLs remain active.
Adjusting Timeout
The idle timeout resets on every operation (exec, file access, agent activity). Default: 300s.
bash
1oc sandbox set-timeout sb-abc123 3600 # 1 hour
Killing a Sandbox
bash
1oc sandbox kill sb-abc123
All data is lost unless you've created a checkpoint first.
Common Patterns
Create and Shell In
bash
1oc shell $(oc create --json | jq -r '.sandboxID')
Filter Running Sandboxes
bash
1oc ls --json | jq '.[] | select(.status == "running") | .sandboxID'
Batch Cleanup
bash
1oc ls --json | jq -r '.[].sandboxID' | xargs -I{} oc sandbox kill {}
SDK usage: Sandboxes. Full flags: CLI Reference.