Commander installation

Setup and manage your Lisk node conveniently with Lisk Commander.

This setup option is only supported for Lisk Core version v2.0.0 and higher. If you have Lisk Core v1.6 or other previous lower versions installed, you will not be able to upgrade your node with Lisk Commander. In this case, use the bash script or remove your old version and install the latest version with Lisk Commander.

Pre-Install

To complete the installation some prerequisites need to be fulfilled. If you have already performed these, please proceed to the Installation chapter.

Install Lisk Commander

Please access the Lisk Commander docs and follow the installation instructions.

Once Lisk Commander is set up on your system, it is possible to use the commands below to set up and manage your Lisk Core node.

Installation

Do not run this command with a user that has sudo rights.
If this is executed then the installation will be aborted, as it is not required and not recommended to install Lisk Core for a user with sudo rights.

Please choose the name of your Lisk Core instance.

Please note that you need to refer to your custom name instead of lisk-mainnet or lisk-testnet when running these commands.

  • Betanet

  • Mainnet

  • Testnet

lisk core:install --network=betanet lisk-betanet

This will install the latest version of Lisk Core into a directory ~/.lisk/instances/lisk-betanet.

To verify your node is running correctly, execute the following command:

lisk core:status lisk-betanet
All available options can be seen in the Lisk Commander Command reference for Lisk Core as well as the general Command reference.

Available options

Add one or multiple of the options below to the core:install command. Multiple options are seperated by spaces.

Full Name Short Name Examples Description

--network

-n

  • --network=testnet

  • --network=betanet

  • -n=alphanet

  • --network=devnet

The network, you want to Lisk Core to connect to. If you don not specify this option, it will connect to the default network (Mainnet).

--release-url

-r

--release-url=https://my-custom.url/testnet/2.1.0-rc.0/lisk-2.1.0-rc.0-Linux-x86_64.tar.gz

Define a custom URL for downloading the new Lisk Core binary script. You also need to have the checksum for the TAR file with the format 2.0.0-Linux-x86_64.tar.gz.SHA256 for the Commander to check the integrity of the binary. Please refer to the binary release for the file naming convention.

--lisk-version

N/A

  • --lisk-version=2.0.0

  • --lisk-version=2.1.3

Define the exact version that Lisk Core should be upgraded to. If you do not specify the version, it will install the latest stable version of Lisk Core.

--snapshot-url

-s

--snapshot-url=http://snapshots.lisk.io.s3-eu-west-1.amazonaws.com/lisk/testnet/lisk_test_backup-9299232.gz

Define a custom URL for downloading the snapshot, that should be used during the setup of Lisk Core.

--no-snapshot

N/A

N/A

Set this option, if you do not wish to use any snapshot during the setup of Lisk Core. In this case, your node will synchronize the whole blockchain, starting from the genesis block. If you choose this option, the setup process will take significantly longer.

--no-start

N/A

N/A

Set this option, if you do not wish to start Lisk Core automatically after the installation.

Post-Install

After the installation is completed, check which ports Lisk Core is listening to by checking the status using the following commands below:

  • Mainnet

  • Testnet

lisk core:status lisk-mainnet
lisk core:status lisk-testnet

Check you network settings to verify the corresponding ports are open.

In addition it is also recommended to set up a log rotation.

If you are not running Lisk locally, you will need to follow the Configuration - API guide to enable access.

If all of the above steps have been successfully completed, the next step is to move on to the configuration section. If you wish to enable forging or SSL, please see General Configuration.