bhatti snapshot export
Export a named snapshot as a tar + zstd archive.
Synopsis
bhatti snapshot export <snapshot-name> [-o <archive.tar.zst>] [--include-base]
Description
The archive includes the snapshot manifest and root disk changes. A memory snapshot additionally carries RAM/CPU/device state, attached-volume copies and network policy. A filesystem snapshot captures only the root disk; it cold-boots a fresh sandbox without attached volumes or the source's network policy, so preserve volume data separately. Server-side secret records and grant authorizations are not exported. Credentials already present in captured guest RAM or files remain included, including plaintext injected with --secret; handle the archive as sensitive.
By default the archive goes to stdout; the command refuses to write binary output to a terminal. -o writes a file, using a .partial file until the download finishes. Without --include-base, the destination must already have the same content-addressed root base, not merely an image with the same tier name. Include the base to move to a host without that exact image. Export refuses snapshots that bind host directories with --mount (the other machine doesn't have those paths), or whose attached volume is itself a qcow2 overlay over an external backing file. Export is not live migration; the source continues running after the snapshot was made.
Import always requires the same architecture. Memory snapshots additionally require the same host OS and a CPU supporting the saved guest's features (so a live Mac↔Linux or arm64↔x86_64 move does not work). A --type filesystem snapshot has no saved memory/CPU checkpoint: it can cross macOS↔Linux on the same architecture, then cold-boot on the destination. See Move sandboxes between hosts.
Examples
bhatti snapshot create dev --name dev-ready
bhatti snapshot export dev-ready -o dev-ready.tar.zst
# Stream the base too when the destination has no matching image
bhatti snapshot export dev-ready --include-base | ssh other-host 'bhatti snapshot import -'
Options
| Flag | Default | Description |
| ---- | ------- | ----------- |
| -o, --output <file> | stdout | Write the archive to a file (- means stdout). |
| --include-base | false | Embed the content-addressed root base image in the archive. |
See Global flags for --url, --token, --json, --timing, --data-dir.
See also
bhatti snapshot import— register the archive on its destination- Move sandboxes between hosts — full workflow and compatibility