bhatti snapshot create

Checkpoint a running sandbox to a named snapshot.

Synopsis

bhatti snapshot create <sandbox> —name <snapshot-name>

Description

Captures memory, CPU registers, disk, and running processes from the running sandbox and saves them under <snapshot-name>. The source sandbox is briefly paused during the capture (typically a few seconds for a full snapshot, ~50ms for a diff snapshot if a previous one exists), then resumes.

The snapshot is stored on the server in the user’s snapshot directory (/var/lib/bhatti/snapshots/<user>/). Resume into a new sandbox with bhatti snapshot resume at any time.

--name is required. Names must match [a-zA-Z0-9][a-zA-Z0-9._-]{0,62} — same rules as sandbox names.

Examples

bhatti snapshot create dev --name pre-experiment

checkpoint "pre-experiment" created (512MB)

# Re-running with the same snapshot name overwrites the previous one
bhatti snapshot create dev --name daily

Options

Flag	Default	Description
--name <string>	(required)	Snapshot name.

See Global flags for --url, --token, --json, --timing, --data-dir.

See also

• bhatti snapshot resume — create a sandbox from this snapshot
• bhatti stop — pause the original instead of forking
• API: POST /sandboxes/:id/checkpoint