Overview
Snapshots allow you to bootstrap your Symphony indexer with pre-synchronized data:- Bitcoin node snapshots: Pre-synced Bitcoin Core blockchain data
- Symphony snapshots: Pre-indexed blockchain data and database state
Prerequisites
- Bitcoin Core (22+) with RPC and P2P access
- lz4
- Sufficient disk space (see deployment requirements)
Available Snapshots
Networks supported:- mainnet
- testnet4
- regtest
Bitcoin
Mainnet: https://snapshots.gomaestro.org/bitcoin-node/mainnet/snapshots/20250826.tar.lz4 Testnet: https://snapshots.gomaestro.org/bitcoin-node/testnet/snapshots/20250827.tar.lz4Symphony
Mainnet: https://snapshots.gomaestro.org/symphony/mainnet/snapshots/20250826.tar.lz4 Testnet: https://snapshots.gomaestro.org/symphony/testnet/snapshots/20250827.tar.lz4Testnet setup example
1. Clone Repository and Prepare Directories
The following are to be excuted within maestro-symphony repo directory. First, let’s clone the Symphony repo:2. Download Snapshots
Bitcoin node snapshot:3. Start Services
Verification
Once the services are started, verify the setup:Check Symphony Status
Stop Services
When you are finished interacting with Symphony, be sure to stop the services as well.Troubleshooting
Disk Space
Ensure sufficient disk space:- Testnet: ~1GB for Symphony + ~50GB for Bitcoin node
- Mainnet: ~24GB for Symphony + ~600GB for Bitcoin node
Snapshot Age
If snapshots are older than expected:- Symphony will automatically sync missing blocks
- Bitcoin Core will resume from snapshot point
- Initial startup may take longer for older snapshots
Updating Snapshots
Snapshots are updated regularly. To use a newer snapshot:- Stop Docker services
- Backup any important data
- Remove old data directories
- Download and extract new snapshots
- Restart Docker services
🎉 You’re Done!
You have now walked through a guide on how to load both a Symphony and Bitcoin snapshot. Be sure to check out Maestro’s additional services for further assisting your development of building on Bitcoin.Support
For issues with snapshots:- Open an issue
- Join the Discord community