From 8626298dcb6dc84fc6bdf6ed380e0e6abf87a051 Mon Sep 17 00:00:00 2001 From: William Law Date: Thu, 23 Jul 2026 13:41:15 -0400 Subject: [PATCH 1/4] chore(snapshots): documentation clarification --- docs/base-chain/node-operators/snapshots.mdx | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/docs/base-chain/node-operators/snapshots.mdx b/docs/base-chain/node-operators/snapshots.mdx index 3189b4d45..ef964e217 100644 --- a/docs/base-chain/node-operators/snapshots.mdx +++ b/docs/base-chain/node-operators/snapshots.mdx @@ -6,6 +6,10 @@ description: Download and restore Base node snapshots to significantly reduce in Using a snapshot significantly reduces the initial time required to sync a Base node. Snapshots are updated regularly. + +A snapshot configuration website is coming soon. It will help you choose a preset or customize the data you download for your node. This guide will be updated with a link when the website launches. + + If you're a prospective or current Base node operator, you can restore from a snapshot to speed up your initial sync. Follow the steps below carefully. ## Restoring from Snapshot @@ -30,7 +34,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 | |--------------|-------------|------------------------------------------------------------------------------|-------------------------------------------------------------| @@ -42,6 +46,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. + The above presets are convenient defaults. 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 From fbc9e4704f5a01a91d7c5ec3a98b5f59b2f128ff Mon Sep 17 00:00:00 2001 From: William Law Date: Thu, 23 Jul 2026 13:54:52 -0400 Subject: [PATCH 2/4] faq --- docs/base-chain/node-operators/snapshots.mdx | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/base-chain/node-operators/snapshots.mdx b/docs/base-chain/node-operators/snapshots.mdx index ef964e217..8c3d91e38 100644 --- a/docs/base-chain/node-operators/snapshots.mdx +++ b/docs/base-chain/node-operators/snapshots.mdx @@ -140,5 +140,11 @@ 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. + + + + +Please interrupt the download command and re-run it. The download is idempotent, so it wont redownload everything it has already downloaded. This is caused due to a newer snapshot being uploaded during the time your download is happening. + From 06b8b8e9cbd52ab992a1df0d43c17429df140b36 Mon Sep 17 00:00:00 2001 From: William Law Date: Fri, 24 Jul 2026 13:11:22 -0400 Subject: [PATCH 3/4] feedback --- docs/base-chain/node-operators/snapshots.mdx | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/docs/base-chain/node-operators/snapshots.mdx b/docs/base-chain/node-operators/snapshots.mdx index 8c3d91e38..073b26b04 100644 --- a/docs/base-chain/node-operators/snapshots.mdx +++ b/docs/base-chain/node-operators/snapshots.mdx @@ -6,10 +6,6 @@ description: Download and restore Base node snapshots to significantly reduce in Using a snapshot significantly reduces the initial time required to sync a Base node. Snapshots are updated regularly. - -A snapshot configuration website is coming soon. It will help you choose a preset or customize the data you download for your node. This guide will be updated with a link when the website launches. - - If you're a prospective or current Base node operator, you can restore from a snapshot to speed up your initial sync. Follow the steps below carefully. ## Restoring from Snapshot @@ -46,7 +42,7 @@ 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. - The above presets are convenient defaults. 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. + 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 @@ -144,7 +140,9 @@ Base's `--full` snapshot uses a 31-day rolling retention window instead. If a sm -Please interrupt the download command and re-run it. The download is idempotent, so it wont redownload everything it has already downloaded. This is caused due to a newer snapshot being uploaded during the time your download is happening. +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. From 6d5895c72575d4cc8da25ba8bc2ddf4f0768f392 Mon Sep 17 00:00:00 2001 From: William Law Date: Fri, 24 Jul 2026 13:18:29 -0400 Subject: [PATCH 4/4] nit --- docs/base-chain/node-operators/snapshots.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/base-chain/node-operators/snapshots.mdx b/docs/base-chain/node-operators/snapshots.mdx index 073b26b04..3f95a8dee 100644 --- a/docs/base-chain/node-operators/snapshots.mdx +++ b/docs/base-chain/node-operators/snapshots.mdx @@ -138,7 +138,7 @@ Base's `--full` snapshot uses a 31-day rolling retention window instead. If a sm - + 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.