Skip to main content
A .gandalf bundle is a portable archive of a snapshot. Use bundles to move your reviewed setup between machines, share a baseline with a teammate, or hand off state to a fresh install. Every step of the bundle workflow supports verification and preview before any file is written.
1

Export a snapshot

Export requires the snapshot name and an output path. Add --metadata-only to skip file content.
The output prints the bundle path and checksum.
2

Verify the bundle

Check format, checksums, and signature. Verify exits non-zero if anything fails.
3

Inspect metadata

Print bundle format version, snapshot name, content flag, and checksum.
4

Dry-run import

Preview the import without writing anything.
The output shows the target snapshot name, evidence count, and any warnings.
5

Apply content on another machine

Applying bundled file content requires --experimental. Quarantine known sensitive prefixes on first import.
Drop --quarantine once you have reviewed the quarantined items:
Bundle content apply refuses known sensitive prefixes and requires --experimental or GANDALF_EXPERIMENTAL=1. Preview with --dry-run or --quarantine first.

​
Readiness

Run gandalf doctor --project . on the target machine to surface missing tools or env keys before importing. Doctor reports what is missing without installing anything.