Skip to content

docs: update validator snapshot guidance#398

Draft
emmajam wants to merge 1 commit into
mainfrom
ejh/minimal-snapshot-docs
Draft

docs: update validator snapshot guidance#398
emmajam wants to merge 1 commit into
mainfrom
ejh/minimal-snapshot-docs

Conversation

@emmajam
Copy link
Copy Markdown
Member

@emmajam emmajam commented May 12, 2026

Summary

  • Document that tempo download uses minimal snapshots by default for validators
  • Restore the snapshots viewer link at https://snapshots.tempo.xyz
  • Keep archive guidance scoped to RPC providers and indexers

Validation

  • git diff --check
  • bun run build

@vercel
Copy link
Copy Markdown

vercel Bot commented May 12, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
tempo-docs Ready Ready Preview, Comment May 18, 2026 10:19am

Request Review

| `--list` | List available snapshots |
| `--resumable` | Resume an interrupted download |
| `--archive` | Download an archive snapshot. Recommended for partner validators and RPC nodes. |
| `--minimal` | Download a minimal snapshot. This is the default and is recommended for validators. |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

--full?


Download chain snapshots for faster initial sync. Fetches MDBX state and static files, and generates a `reth.toml` prune config for the target data directory.

By default, `tempo download` downloads a minimal snapshot, which is recommended for validators to save disk space. Use archive snapshots for RPC providers, indexers, and other workloads that need complete historical data.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

by default, it opens a TUI

Image


By default, `tempo download` downloads a minimal snapshot, which is recommended for validators to save disk space. Use archive snapshots for RPC providers, indexers, and other workloads that need complete historical data.

## Usage
Copy link
Copy Markdown
Contributor

@jenpaff jenpaff May 20, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

we should also mention --force + a section on how to migrate

@@ -46,17 +46,25 @@ docker logs tempo

## Snapshots
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would add a careful note about which snapshot should be used if minimal migration hasn't been done yet

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants