snapshot

Publish an immutable snapshot event (kind 5128) that pins the current state of the root or a named site at a specific moment. The snapshot is built from the current site manifest's aggregate hash and contents, so future readers can verify they are looking at the same blob set the snapshot was made from. Unlike the regular site manifest, a snapshot event is not meant to be replaced — each publish records a new historical point.

Usage

nsyte snapshot [options]

Options

• -r, --relays <relays> — The nostr relays to use (comma separated)
• --sec <secret> — Secret for signing (auto-detects format: nsec, nbunksec, bunker:// URL, or 64-char hex)
• --prompt-sec — Prompt for the signing secret at runtime instead of --sec (keeps it out of shell history)
• -d, --name <name> — The site identifier for named sites (kind 35128). If not provided, snapshots the root site (kind 15128)
• --title <title> — Title for this snapshot. Defaults to the source manifest's title
• --no-title — Omit the title inherited from the source manifest
• --description <description> — Description for this snapshot. Defaults to the source manifest's description
• --no-description — Omit the description inherited from the source manifest
• --dry-run — Preview the snapshot event without signing or publishing it
• --dry-run-output <dir> — Directory to write dry-run event JSON files
• --dry-run-show-kinds <kinds> — Also print events of these kinds to stdout (comma-separated kind numbers)
• --no-config — Ignore config file and use only CLI arguments (default: false)
• --use-fallback-relays — Include default nsyte relays in addition to configured relays
• --use-fallbacks — Enable all fallbacks (currently only relays for this command)

Examples

Preview a snapshot for the current root site without publishing:

nsyte snapshot --dry-run

Publish a snapshot of the root site:

nsyte snapshot

Publish a snapshot for a named site, including fallback relays:

nsyte snapshot -d docs --use-fallback-relays

Label a snapshot with a release tag, leaving the live site untouched:

nsyte snapshot --title "v1.2.3" --description "Release v1.2.3"

Snapshot Labels

A snapshot inherits its descriptive tags — title, description, source, app, server, relay — from the manifest it is taken from. --title and --description set those tags on this snapshot only; the live manifest is never rewritten, so there is no need to retitle a site, redeploy, snapshot, and put the title back just to label a release. --no-title and --no-description drop the inherited tag instead of replacing it.

The verifiable parts of a snapshot — the aggregate hash and the file set — always come from the source manifest and cannot be overridden.

See Also

• nsyte deploy — Publish a new site manifest from a directory
• nsyte status — Inspect manifest history and relay coverage
• nsyte ls — List files currently in a site manifest

Inherits global options. See global options.