Database Snapshots 📸

You can download a snapshot of the Juno database to reduce the network syncing time. Only the blocks created after the snapshot will be synced when you run the node. Fresh snapshots are automatically uploaded once a week and are available under the links below.

Snapshots are provided in a compressed .tar.zst format for faster downloads and reduced storage requirements. It also allows you to directly stream the decompressed file to your computer without needing to download it first.

Network	Version	Download Link
Mainnet	>=v0.13.0	juno_mainnet.tar.zst
Sepolia	>=v0.13.0	juno_sepolia.tar.zst
Sepolia-Integration	>=v0.13.0	juno_sepolia_integration.tar.zst

Getting snapshot sizes

$date
Tue Aug 26 11:00:52 WEST 2025

$curl -s -I -L https://juno-snapshots.nethermind.io/files/mainnet/latest | gawk -v IGNORECASE=1 '/^Content-Length/ { printf "%.2f GB\n", $2/1024/1024/1024 }'
195.13 GB

$curl -s -I -L https://juno-snapshots.nethermind.io/files/sepolia/latest | gawk -v IGNORECASE=1 '/^Content-Length/ { printf "%.2f GB\n", $2/1024/1024/1024 }'
32.84 GB

$curl -s -I -L https://juno-snapshots.nethermind.io/files/sepolia-integration/latest | gawk -v IGNORECASE=1 '/^Content-Length/ { printf "%.2f GB\n", $2/1024/1024/1024 }'
7.33 GB

Run Juno with a snapshot

This method downloads and extracts the snapshot in one step without requiring double disk space:

1. Prepare a directory

Ensure you have a directory to store the snapshots. We will use the $HOME/snapshots directory:

mkdir -p $HOME/snapshots

2. Install zstd

zstd (Zstandard) is required to decompress and directly stream the snapshots into your system without requiring temporary storage. zstd provides significantly better compression ratios and faster decompression speeds compared to traditional tar compression.

# On Ubuntu/Debian
sudo apt-get install zstd

# On macOS
brew install zstd

# On RHEL/CentOS/Fedora
sudo dnf install zstd  # or yum install zstd

3. Download and extract

Two-step approach where we first download the snapshot and extract it later. Note that this will create the requirement to have twice the space required for the Juno snapshot. If space is not enough you can always try the alternative method below.

1. Download the snapshot

# For Mainnet
wget --continue -O "$HOME/snapshots/juno_mainnet.tar.zst" https://juno-snapshots.nethermind.io/files/mainnet/latest


# Or using curl
curl -L -C - -o $HOME/snapshots/juno_mainnet.tar.zst https://juno-snapshots.nethermind.io/files/mainnet/latest

2. Extract the snapshot

Create a subfolder inside $HOME/snapshots where to unzip the downloaded snapshot:

# For Mainnet
mkdir $HOME/snapshots/mainnet/

# Extract to your snapshots directory
zstd -d juno_mainnet.tar.zst -c | tar -xvf - -C $HOME/snapshots/mainnet

Alternative method: Stream the snapshot directly

warning

Streaming can become unreliable if the network conditions are not extremely good, requiring multiple restarts. Resort to this if disk space is at a premium.

Create a subfolder inside $HOME/snapshots where to stream the download:

# For Mainnet
mkdir $HOME/snapshots/mainnet/

Download and extract the snapshot directly to your target directory:

# For Mainnet
curl -s -L https://juno-snapshots.nethermind.io/files/mainnet/latest \
| zstd -d | tar -xvf - -C $HOME/snapshots/mainnet

For other networks, replace the URL with:

• Sepolia: https://juno-snapshots.nethermind.io/files/sepolia/latest
• Sepolia-Integration: https://juno-snapshots.nethermind.io/files/sepolia-integration/latest

Running Juno with snapshots

1. Run Juno

Run the Docker command to start Juno:

docker run -d \
  --name juno \
  -p 6060:6060 \
  -v $HOME/snapshots/mainnet:/var/lib/juno \
  nethermind/juno \
  --http \
  --http-port 6060 \
  --http-host 0.0.0.0 \
  --db-path /var/lib/juno \
  --eth-node <YOUR-ETH-NODE>

info

Replace <YOUR-ETH-NODE> with your Ethereum node WebSocket URL (e.g., wss://mainnet.infura.io/ws/v3/your-project-id). Ensure you use the WebSocket URL (ws/wss) instead of the HTTP URL (http/https).