How to restore snapshot with full state history


This procedure restores an existing snapshot with full history, so the node can become active in the blockchain.

Before you begin


  1. Get the following:

    • A portable snapshot (data/snapshots/snapshot-xxxxxxx.bin)
    • The contents of data/state-history
    • Optional: a block log which includes the block the snapshot was taken at. Do not include data/blocks/reversible.
  2. Make sure data/state does not exist
  3. Start nodeos with the --snapshot option, and the options listed in the state_history_plugin.
  4. Do not stop nodeos until it has received at least 1 block from the network, or it won't be able to restart.


If nodeos fails to receive blocks from the network, then try the above using net_api_plugin. Use cleos net disconnect and cleos net connect to reconnect nodes which timed out.

Caution when using net_api_plugin

Either use a firewall to block access to http-server-address, or change it to localhost:8888 to disable remote access.