Nolus Docs
NetworkRun a full node

Bootstrap from a snapshot

Skip syncing from genesis - recover state from a Nolus-provided snapshot.

A snapshot contains a compressed copy of the Nolus chain data and wasm directories. It lets a new node join quickly by restoring application state instead of replaying every block from genesis. Recommended for new participants. Always double-check the source.

The Nolus-provided snapshot is pruned. It's suitable for a validator node but not for an RPC/archive node.

The snapshot index lives at snapshots.nolus.network/backup/snapshots/.

Steps

  1. Stop the nolusd process or service:

    nolusd stop

  2. Download the latest snapshot:

    wget -O nolus_snapshot.tar.gz https://snapshots.nolus.network/backup/snapshots/pirin-1_XXXX-XX-XX_XX-XX-XX.tar.gz --inet4-only

  3. If you're validating, back up priv_validator_state.json first (otherwise skip):

    cp ~/.nolus/data/priv_validator_state.json ~/.nolus/priv_validator_state.json

  4. Reset node state:

    nolusd tendermint unsafe-reset-all --home $HOME/.nolus --keep-addr-book

  5. Remove the current data and wasm directories:

    rm -r ~/.nolus/data
rm -r ~/.nolus/wasm

  6. Unpack the snapshot into the node directory:

    tar -xzf nolus_snapshot.tar.gz --strip-components=1 -C $HOME/.nolus/

  7. If you backed up priv_validator_state.json, restore it (otherwise skip):

    cp ~/.nolus/priv_validator_state.json ~/.nolus/data/priv_validator_state.json

  8. Restart nolusd. Make sure persistent peers and genesis.json are still in place:

    nolusd start

Run the node

Start nolusd (with or without Cosmovisor), check sync status, tail logs.

Validators

Create, restore, and unjail a Nolus validator.

On this page

Steps