Skip to content

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