Skip to content

chore(snapshots): documentation clarification #1734

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
wlawt merged 4 commits into from
Jul 24, 2026
Merged

chore(snapshots): documentation clarification #1734

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
8626298
chore(snapshots): documentation clarification
wlawt Jul 23, 2026
fbc9e47
faq
wlawt Jul 23, 2026
06b8b8e
feedback
wlawt Jul 24, 2026
6d5895c
nit
wlawt Jul 24, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 11 additions & 1 deletion docs/base-chain/node-operators/snapshots.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ These steps use the `base-reth-node` CLI to download snapshots. If you don't alr
| Base Mainnet | `base` |
| Base Sepolia | `base-sepolia` |

3. **Download Snapshot**: Choose the appropriate snapshot for your network and client from the table below.
3. **Download Snapshot**: V2 snapshots are split into many small, segmented files rather than a single archive. The CLI lists one `archive` snapshot because it contains all available files. The `full` and `minimal` options select progressively smaller subsets of that archive:

| Config | Flag | What you get | Use when |
|--------------|-------------|------------------------------------------------------------------------------|-------------------------------------------------------------|
Expand All @@ -42,6 +42,8 @@ These steps use the `base-reth-node` CLI to download snapshots. If you don't alr
Ensure you have enough free disk space to download the snapshot _and_ extract its contents. The extracted data will be significantly larger than the archive.
</Note>

The above presets are convenient defaults that are available at [chain.base.org/snapshots](https://chain.base.org/snapshots). You may still configure custom pruning flags with the [flag](https://github.com/base/node/blob/main/.env.mainnet#L55). It is required to download the archival snapshot and then configure your custom pruning args.

```bash
# Minimal node on Base Mainnet
base-reth-node download --minimal --datadir ./reth-data --chain base --resumable
Expand Down Expand Up @@ -134,5 +136,13 @@ In Reth, a "full" node is just a pruned node with a specific preset rather than

Base's `--full` snapshot uses a 31-day rolling retention window instead. If a smaller storage footprint is preferred, you can override `reth.toml` to match the 10,064-block preset.

</Accordion>

<Accordion title="I'm seeing: Archive extracted, but output verification failed.">

This is caused due to a newer snapshot being uploaded during the time your download is happening. Please interrupt the download command and re-run it.

Note: The download is idempotent, so it will not re-download files that have already been downloaded; it will only fetch the diff.

</Accordion>
</AccordionGroup>
Loading