Use the Stacks blockchain archive

Where to download archives

Stacks blockchain archives for each network can be found at the following locations:

• mainnet: https://archive.hiro.so/mainnet/stacks-blockchain/
• testnet: https://archive.hiro.so/testnet/stacks-blockchain/

The file name patterns are as follows:

• archive: <NETWORK>-stacks-blockchain-<VERSION>-<DATE(YYYYMMDD)>.tar.gz
• shasum: <NETWORK>-stacks-blockchain-<VERSION>-<DATE(YYYYMMDD)>.sha256

There is a continually updated archive and shasum which always points to the most recent upload:

• archive: <NETWORK>-stacks-blockchain-latest.tar.gz
• shasum: <NETWORK>-stacks-blockchain-latest.sha256

or the most recent upload for a particular version:

• archive: <NETWORK>-stacks-blockchain-2.3.0.0.2-latest.tar.gz
• shasum: <NETWORK>-stacks-blockchain-2.3.0.0.2-latest.sha256

Restoring a Stacks blockchain node using the Hiro Archive

1. 1Download the archive and shasum for the appropriate network.
2. 2Verify the archive with the shasum.
3. 3Extract the archive into the desired directory:
   Terminal

   $ 
   tar -zxvf <ARCHIVE FILE> -C /target/directoryCopy

4. 4Configure the working_dir property in your Stacks blockchain node Config.toml file to match the directory you extracted the archive to.
5. 5Launch your Stacks blockchain node. You can use one of these example configuration files as a reference.
6. 6Verify the dataset is being used by comparing your nodes local block height with Hiro's. If the block height matches or is close to Hiro's block height, the restoration was successful.
   1. 1It may take a few minutes for the local node to respond on this endpoint.
   2. 2Your block height may be up to a few hundred blocks away from Hiro's depending on the age of the archive. It should catch up relatively quickly.