Ethereum Client Snapshots

Node data directory snapshots for clients across different Ethereum networks. Regularly updated snapshots help you quickly sync nodes for testing environments.

#execution-client #ethereum-node #snapshots

Disclaimer: The snapshots provided are intended solely for testing and development purposes. They are not guaranteed to reflect the current state, data, or functionality of the canonical Ethereum Network. Use of these snapshots is at your own risk, and no representations or warranties, either express or implied, are made regarding their accuracy, completeness, or reliability in comparison to the Ethereum Network. These snapshots should not be used in production or as a substitute for interacting with the canonical Ethereum Network. Always manually verify the state against the Ethereum Network to ensure consistency and accuracy.

Recent snapshots

These snapshots are regularly updated and at the same block height. They can help you quickly sync your node.

🌐 Mainnet
🐬 Sepolia
🦚 Hoodi
🐱 Holesky
ℹ️ Quickstart Guide

Loading snapshot data...

Quickstart

TLDR: Just use Docker to download and untar the snapshot

If you have docker installed, this is the easiest way to download and untar a snapshot, without having to install any other dependencies:

docker run --rm -it \
  -v $PWD:/data \
  --entrypoint "/bin/sh" \
  alpine -c \
  "apk add --no-cache curl tar zstd && \
  BLOCK_NUMER=$(curl -s https://snapshots.ethpandaops.io/hoodi/geth/latest) && \
  echo \"Downloading snapshot for block number: $BLOCK_NUMER\" && \
  curl -s -L https://snapshots.ethpandaops.io/hoodi/geth/$BLOCK_NUMER/snapshot.tar.zst | \
  tar -I zstd -xvf - -C /data"

Detailed example: Getting a Hoodi Geth data dir snapshot

Verify when the latest snapshot was taken:

# Get the most recent block number for a snapshot
export BLOCK_NUMBER=$(curl -s https://snapshots.ethpandaops.io/hoodi/geth/latest)
echo $BLOCK_NUMBER

# Check information about the latest block:
curl -s https://snapshots.ethpandaops.io/hoodi/geth/$BLOCK_NUMER/_snapshot_eth_getBlockByNumber.json

# Or just get the block number:
printf '%d\n' $(
    curl -s https://snapshots.ethpandaops.io/hoodi/geth/$BLOCK_NUMBER/_snapshot_eth_getBlockByNumber.json |
    jq -r '.result.number'
)

# Or just the time when it was taken
printf '%d\n' $(
    curl -s https://snapshots.ethpandaops.io/hoodi/geth/$BLOCK_NUMBER/_snapshot_eth_getBlockByNumber.json |
    jq -r '.result.timestamp'
)

Then, also check which client version was used during the snapshot:

# Get client version. Can be important, depending on the version that you want to run.
curl -s https://snapshots.ethpandaops.io/hoodi/geth/$BLOCK_NUMBER/_snapshot_web3_clientVersion.json | jq -r '.result'

If you're happy with the version and the timestamp of the most recent snapshot, you can download it like:

# Download the whole snapshot
curl -O https://snapshots.ethpandaops.io/hoodi/geth/$BLOCK_NUMBER/snapshot.tar.zst

# Or .. use range requests to be able to resume a download if it fails due to network connectivity issues.
# This is very useful when downloading big snapshots, e.g. the mainnet ones.
# Alternatively you can also use tools like `aria2`.
curl --continue-at - https://snapshots.ethpandaops.io/hoodi/geth/$BLOCK_NUMBER/snapshot.tar.zst -O

# Or... download and untar at the same time. Safes you disk space, so you don't have to store the full compressed file.
curl -s -L https://snapshots.ethpandaops.io/hoodi/geth/$BLOCK_NUMBER/snapshot.tar.zst \
| tar -I zstd -xvf - -C $PATH_TO_YOUR_GETH_DATA_DIR

# Or.. use a docker container with all the tools you need (curl, zstd, tar) and untar it on the fly
docker run --rm -it \
  -v $PWD:/data \
  --entrypoint "/bin/sh" \
  alpine -c \
  "apk add --no-cache curl tar zstd && \
  BLOCK_NUMER=$(curl -s https://snapshots.ethpandaops.io/hoodi/geth/latest) && \
  echo \"Downloading snapshot for block number: $BLOCK_NUMER\" && \
  curl -s -L https://snapshots.ethpandaops.io/hoodi/geth/$BLOCK_NUMER/snapshot.tar.zst | \
  tar -I zstd -xvf - -C /data"

Snapshot generation status

The following shows the current status of snapshot generation for each network. You'll also be able to see when the next snapshot is going to happen. If snapshots are being created, this section will display their progress in real-time.

🌐 Mainnet
🐬 Sepolia
🦚 Hoodi
🐱 Holesky

Loading snapshot status...

Recent snapshots​

Quickstart

TLDR: Just use Docker to download and untar the snapshot

Detailed example: Getting a Hoodi Geth data dir snapshot

Snapshot generation status​

Recent snapshots

Snapshot generation status