GuidesDiscussions & SupportGitHubLog In

Syscoin 4.1.3 Upgrade Guide

Upgrade/Installation Guide:

Backup FIRST!

  1. Base on your OS, locate your wallet.dat within your Data Folder. This file contains your private key information so please back up this file before proceeding.
  • For Windows, the Data Folder is located at

  • For Linux, the Data Folder is located at

  • For MacOS, the Data Folder is located at
    ~/Library/Application Support/Syscoin

  1. Copy the wallet.dat to somewhere safe

  2. Ensure syscoind is not running before proceeding!


On Windows, please download the latest version here: https://github.com/syscoin/syscoin/releases

If you prefer an installer, use "win64-setup"
If you prefer a zipped standalone version, use "win64zip"
If you previously used the installer for installing 4.0.3, you'll need to uninstall 4.0.3 first.
If you can't locate the uninstaller, go to Settings -> Apps & Features and locate Syscoin Core and click on Uninstall.
The uninstallation process will remove previous software, not your wallet data.

After Syscoin 4.0.x is uninstalled, please proceed to installing 4.1.3 normally.

After Syscoin 4.1.3 is installed, launch Syscoin with the reindex flag on. Use this guide for a simple walk-through of reindexing.

Linux + MacOS

On Linux and MacOS, you can choose to use the pre-built binary (.dmg for MacOS) or build from source code:

Compiling from source code

If you ran 4.0.3 before, please do the following first before checking out the latest code:

cd ~/syscoin
git checkout v4.0.3
sudo make uninstall
make clean

This uninstall the 4.0.3 binaries from /usr/local/bin and then clean up the repo
Proceed as usual after

git checkout v4.1.3
sudo make install

Start syscoind with the reindex flag on. Use this guide for a simple walk-through of reindexing.

Linux: Using Pre-built Binaries

Download the binary

wget https://github.com/syscoin/syscoin/releases/download/v4.1.3/syscoin-4.1.3-x86_64-linux-gnu.tar.gz

Check the shasum of the file (It shouldu say OK)

echo "858f0e24be6c999aabe8cd9a682ac3b8bdf24dbc42c36566536701faf85824f4 syscoin-4.1.3-x86_64-linux-gnu.tar.gz" | sha256sum -c

Unzip the file

tar xf syscoin-4.1.3-x86_64-linux-gnu.tar.gz

Install the binaries to /usr/local/bin

sudo install -m 0755 -o root -g root -t /usr/local/bin syscoin-4.1.3/bin/*

Start syscoind with the reindex flag on. Use this guide for a simple walk-through of reindexing.


Masternode Install/upgrade guide can be found here:

Start syscoind with the reindex flag on. Use this guide for a simple walk-through of reindexing.


1. geth_sync_status stuck

If getblockchaininfo shows that geth_sync_status stuck at waiting, check if the following processes are running:

  • If sysrelayer.nod is not running, please find the Installation Folder for Syscoin Core
    default path is as the following
    Windows: C:\Program Files\Syscoin
    MacOS: /Applications/Syscoin-Qt.app/Contents/MacOS/
    Linux: /usr/local/bin
    Check if a file named scrypt.node exists in your Installation Folder. If yes, remove this file and restart Syscoin

  • If sysrelayer.nod is running, please give Geth some times to sync (~30 minutes). If it's still not synced, please delete the geth data directory from your Data Folder and try again. The default path is at the following:
    Windows: %appdata%\Syscoin\geth
    MacOS: ~/Library/Application Support/Syscoin/geth
    Linux: ~/.syscoin/geth

2. Blocks not syncing due to no peer

If the block is not syncing, and you see an empty peer list, please launch the console and enter the following command:
addnode onetry

3. Transaction not being received / Blockchain not synced

Check if you're still on 4.0.3. If you are, please upgrade to 4.1.3 (see above) and the issue the following command once the node is up
syscoin-cli reconsiderblock 544454cae7e82aca8ca5cfb942b9f64d484bd7b8300d47bb90fd2c50f9134eff