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 snapshotbhatti stop— pause the original instead of forking- API:
POST /sandboxes/:id/checkpoint