Skip to main content

Creating a Sandbox

oc create (shortcut for oc sandbox create) provisions a new sandbox VM:
The sandbox ID is printed on success. Use --json to capture it programmatically:

Listing & Inspecting

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.
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.

Killing a Sandbox

All data is lost unless you’ve created a checkpoint first.

Common Patterns

Create and Shell In

Filter Running Sandboxes

Batch Cleanup

SDK usage: Sandboxes. Full flags: CLI Reference.