Skip to main content
Version: 0.16.0

Sync from a Snapshot

It is possible to avoid syncing from the beginning and waiting weeks to catch up by downloading a Juno snapshot. You're downloading a pre-synced Juno database that you can point your node to. This will reduce the syncing time to just a few hours.

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.

Additionally, pruned snapshots are offered. They contain only the latest data, greatly reducing storage size.

Network Snapshots​

NetworkDownload Link
Mainnetjuno_mainnet.tar.zst
Mainnet (Pruned)juno_mainnet_pruned.tar.zst
Sepoliajuno_sepolia.tar.zst
Sepolia (Pruned)juno_sepolia_pruned.tar.zst
Sepolia-Integrationjuno_sepolia_integration.tar.zst
tip

Select your network in any tab below and the rest of the page follows. The choice is synced across every command on this page.

Getting snapshot sizes​

Snapshot sizes as of Fri Jul 31 2026:

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 }'
# 453.93 GB

Run Juno with a snapshot​

You can either stream the snapshot directly into the target directory without storing the archive, or download the snapshot archive and then extract it. All commands below run in your current directory, so cd into the location where you want the snapshot first. Both methods share the first step:

1. 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.

sudo apt-get install zstd

2. Get the snapshot​

Streaming downloads and extracts the snapshot in a single step, reducing required disk space to just the size of the extracted database, contrary to Download, which additionally needs space for the compressed archive.

1. Install streaming dependencies​

Streaming requires either wget or lftp installed on your computer.

These allow the zstd and tar context to survive a network error, restarting the transfer seamlessly and keeping the stream going even in the worst of network connections.

wget is usually preinstalled on Linux distributions. If missing:

sudo apt-get install wget
2. Stream the snapshot​

Create a subfolder in your current directory where to stream the download, then download and extract the snapshot directly to your target directory:

mkdir -p juno_mainnet

Stream the data to your computer:

  1. wget streams the data reliably and comes preinstalled on most systems.
  2. lftp + pv is a solid alternative if you've no access to wget.
  3. curl gives no guarantees. Use it only as a last resort.
wget --tries=0 --retry-connrefused --retry-on-http-error=500,502,503,504 --read-timeout=60 -O - \
  https://juno-snapshots.nethermind.io/files/mainnet/latest \
| zstd -d | tar -xf - -C juno_mainnet

Running Juno with snapshots​

1. Run Juno​

From the same directory where you extracted or streamed the snapshot, run the Docker command to start Juno:

docker run -d \
  --name juno \
  -p 6060:6060 \
  -p 6061:6061 \
  -v $(pwd)/juno_mainnet:/var/lib/juno \
  nethermind/juno \
  --http \
  --http-port 6060 \
  --http-host 0.0.0.0 \
  --ws \
  --ws-port 6061 \
  --ws-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, and make sure it matches the network's L1: Starknet Mainnet settles on Ethereum Mainnet (e.g. wss://mainnet.infura.io/ws/v3/your-project-id), while Sepolia and Sepolia-Integration settle on Ethereum Sepolia (e.g. wss://sepolia.infura.io/ws/v3/your-project-id). Ensure you use the WebSocket URL (ws/wss) instead of the HTTP URL (http/https).

tip

These examples use Docker. For other ways to run Juno (standalone binary, building from source) and more configuration details, see the Installation guide.