User Tools

Site Tools


Bootstrapping the Blockchain

Sia's blockchain can take a while to synchronize with the network when installing a new client. While the developers are working on improving the syncing speed, a good workaround for now is to install an auxiliary database.

1. Getting the database

Community member Sanasol made a website for downloading automatically generated database snapshots, which is available from Go ahead and download the file.

2. Installing the database

While the consensus.db file is downloading you need to shut down any running instance of Sia (either siad or Sia-UI). You can close Sia-UI by right clicking the Sia icon in the system tray and choosing “Quit Sia”. If you're running the daemon you need to issue a siac stop command and wait for the shutdown to finish.

When the consensus.db file has finished downloading you need to navigate to your Sia consensus data directory. For users of the commandline client this is in the same place as the siad executable. If you're using Sia-UI it can be found in an operating system-specific location:

Operating system Consensus data directory
GNU/Linux based $HOME/.config/Sia-UI/sia/consensus
Microsoft Windows %APPDATA%\Sia-UI\sia\consensus
Mac OS X $HOME/Library/Application Support/Sia-UI/sia/consensus

In this directory you'll find the consensus.db and consensus.log files that Sia generated when it first ran. Now you need to replace the consensus.db file in that directory with the one you downloaded.

3. Initializing the new database

Now it's time to start Sia again. Sia will automatically detect the new database and start scanning it for transactions that might be related to your wallet. This process is very intensive on the storage medium. It may take several hours on an old hard disk drive, or around one hour on a solid state drive.

If you are starting siad from the terminal you'll see that it hangs on (2/6) Loading consensus…. If you're using the UI it will tell you that upgrading to a newer version will take a while, along with a link to the release notes. This is totally normal, just go work on something else and let Sia do its thing. When it's finished you'll have a fully operational and synchronized Sia client, congratulations!

daemon/bootstrapping_the_blockchain.txt · Last modified: 2017/07/26 10:16 by Fornax