Node Snapshots

​

Restoring from Snapshot

1. Prepare Data Directory:
   • Before running Docker for the first time, create the data directory on your host machine that will be mapped into the Docker container. This directory must match the volumes mapping in the docker-compose.yml file.
     mkdir ./reth-data
     
   • If you have previously run the node and have an existing data directory, stop the node (docker compose down), remove the contents of the existing directory (e.g. rm -rf ./reth-data/*), and proceed.
2. Download Snapshot: Choose the appropriate snapshot for your network and client from the table below. Use wget (or similar) to download it into the node directory.

   Network	Snapshot Type	Download Command (wget …)
   Testnet	Archive (recommended)	wget -c https://sepolia-reth-archive-snapshots.base.org/$(curl https://sepolia-reth-archive-snapshots.base.org/latest)
   Testnet	Pruned	wget -c https://sepolia-reth-pruned-snapshots.base.org/$(curl https://sepolia-reth-pruned-snapshots.base.org/latest)
   Mainnet	Archive (recommended)	wget -c https://mainnet-reth-archive-snapshots.base.org/$(curl https://mainnet-reth-archive-snapshots.base.org/latest)
   Mainnet	Pruned	wget -c https://mainnet-reth-pruned-snapshots.base.org/$(curl https://mainnet-reth-pruned-snapshots.base.org/latest)

   Ensure you have enough free disk space to download the snapshot archive (.tar.gz / .tar.zst file) and extract its contents. The extracted data will be significantly larger than the archive.
3. Extract Snapshot: Untar the downloaded snapshot archive. Replace snapshot-filename with the actual downloaded filename:
   tar -xzvf <snapshot-filename.tar.gz>
   
   # For .tar.zst 
   tar -I zstd -xvf <snapshot-filename.tar.zst>
   
4. Move Data: The extraction process will likely create a reth directory.
   • Move the contents of that directory into the data directory you created in Step 1:
     mv ./reth/* ./reth-data/
     rm -rf ./reth    # Clean up empty extracted folder
     
   • The goal is to have the chain data directories (e.g., chaindata, nodes, segments, etc.) directly inside ./reth-data, not in a nested subfolder.
5. Start the Node: Now that the snapshot data is in place, return the root of your Base node folder and start the node:
   cd ..
   docker compose up --build
   

6. Verify and Clean Up: Monitor the node logs (docker compose logs -f <service_name>) or use the sync monitoring command to ensure the node starts syncing from the snapshot’s block height. Once confirmed, you can safely delete the downloaded snapshot archive (.tar.gz file) to free up disk space.

​

Proofs Snapshots