📹 Video walkthrough: Coming soon
Snapshots let you save and restore complete blockchain states. Think of them as "save games" for your regtest environment.
⚠️ Snapshots are only available in Docker mode.
From the main menu, select 📸 Snapshots:
Create Snapshot
List Snapshots
Restore Snapshot
Compare Snapshots
Delete Snapshot
TUI: Snapshots → Create Snapshot
- Name your snapshot — e.g., "before-rbf-test"
- Add a description — Optional context about the blockchain state
- Add tags — Optional labels for organization
- Select wallets to include — Choose specific wallets or all
Caravan-X captures:
- Current block height and hash
- Complete
regtest/directory (blocks, chainstate, wallets) - Wallet list and balances
- SHA-256 checksum for integrity verification
Snapshots are saved as compressed .tar.gz archives in the profile's snapshots/ directory.
TUI: Snapshots → List Snapshots
Shows all saved snapshots with:
- Name and description
- Block height at time of capture
- Creation date
- File size
- Tags
TUI: Snapshots → Restore Snapshot
- Select the snapshot to restore
- Caravan-X stops Bitcoin Core
- Current blockchain data is backed up
- Snapshot data replaces the current
regtest/directory - Bitcoin Core is restarted
- Connection is verified
⚠️ Restoring replaces your current blockchain state. The current state is automatically backed up before restoration.
TUI: Snapshots → Compare Snapshots
Select two snapshots to see the differences:
- Block height difference
- Wallets added or removed
- Time elapsed between snapshots
Useful for understanding what changed between different states of your testing.
TUI: Snapshots → Delete Snapshot
Removes the snapshot file and its metadata. This action is permanent.