Update Lisk Core (Binary)

How to update the Lisk Core binary distribution to a new version.

1. Download the new Lisk Core version

Download the new Lisk Core version inside of your user home directory.

  • Mainnet

  • Testnet

Linux:

wget https://downloads.lisk.io/lisk/main/3.1.1/lisk-core-v3.1.1-linux-x64.tar.gz
wget https://downloads.lisk.io/lisk/main/3.1.1/lisk-core-v3.1.1-linux-x64.tar.gz.SHA256

MacOS:

wget https://downloads.lisk.io/lisk/main/3.1.1/lisk-core-v3.1.1-darwin-x64.tar.gz
wget https://downloads.lisk.io/lisk/main/3.1.1/lisk-core-v3.1.1-darwin-x64.tar.gz.SHA256

Linux:

wget https://downloads.lisk.io/lisk/test/3.1.1/lisk-core-v3.1.1-linux-x64.tar.gz
wget https://downloads.lisk.io/lisk/test/3.1.1/lisk-core-v3.1.1-linux-x64.tar.gz.SHA256

MacOS:

wget https://downloads.lisk.io/lisk/test/3.1.1/lisk-core-v3.1.1-darwin-x64.tar.gz
wget https://downloads.lisk.io/lisk/test/3.1.1/lisk-core-v3.1.1-darwin-x64.tar.gz.SHA256

2. Verify Checksum

  • Linux

  • MacOS

sha256sum -c lisk-core-v3.1.1-linux-x64.tar.gz.SHA256
# lisk-core-v3.1.0-linux-x64.tar.gz: OK
sha256sum -c lisk-core-v3.1.1-darwin-x64.tar.gz.SHA256

3. Stop Lisk Core

pm2 delete lisk-core

4. Backup Lisk Core

4.1. Backup your custom configs

In case you created custom configurations inside the lisk-core/ folder, make sure to copy or move them out of the lisk-core/ folder before removing them in the next step.

  • custom-config.json: backup the custom configuration for Lisk Core.

  • pm2.conf.json: backup the pm2 config file.

4.2. Backup the application data

tar czf ~/backup_lisk.tar.gz ~/.lisk/

5. Remove the old version

rm -rf ~/lisk-core/

6. Extract the new version

  • Linux

  • MacOS

tar xzf ~/lisk-core-v3.1.1-linux-x64.tar.gz -C ~/
tar xzf ~/lisk-core-v3.1.1-darwin-x64.tar.gz -C ~/

7. Start Lisk Core

Note: If you have configured your pm2.config.json, please use that configuration.

pm2 start pm2.conf.json

8. Sanity Check

Verify the correct version.

lisk-core --version
#lisk-core/3.1.1 linux-x64 node-v18

Check if the new transferFixHeight, serializationFixHeight is correctly set:

  • transferFixHeight, serializationFixHeight value for the Mainnet is 17557156.

  • transferFixHeight, serializationFixHeight value for the Testnet is 15466999.

Example: Checking transferFixHeight, serializationFixHeight for Testnet
lisk-core node:info --pretty | grep "serializationFixHeight\|transferFixHeight"
"transferFixHeight, serializationFixHeight": 15466999
For delegates
For delegates: Don’t forget that Enabling forging again is required after the update.