Guide

These task-oriented guides walk through snapdir's day-to-day workflows, from turning a directory into a content-addressed snapshot to publishing it, restoring it elsewhere, replicating it between stores, and reviewing its history. Start with snapshotting and follow the links from there, or jump straight to the topic you need.

• Snapshotting — describe a directory with manifest, derive its deterministic ID with id, and stage its objects into the local cache.

• Creating a manifest without snapdir — recreate every checksum in a manifest, and the snapshot ID itself, by hand with b3sum and standard shell tools.

• Pushing and pulling — publish a staged snapshot to a store and restore it byte-for-byte verified anywhere.

• Stores — the file://, s3://, gs://, b2://, ssh://, and sftp:// backends and how to configure them.

• Syncing — copy a snapshot directly between two stores, including cross-cloud replication.

• History — track where snapshots live with locations, ancestors, and revisions.

See also the Command reference for every subcommand and flag.