Lisk Core Binary Setup
This document details how to setup Lisk Core Binary distribution on a system.
To complete the installation some prerequisites need to be fulfilled. If you have already performed these, please proceed to the Installation chapter.
Mandatory: Always open the WebSocket port of your desired network, to enable communication with other peer nodes.
To connect to the desired network with Lisk Core, please ensure that the corresponding ports are open:
To run and manage a Lisk Core node in the future, please create a separate
lisk user like so:
It is sufficient to create a group
sudo adduser lisk (1) sudo groupadd docker (2) sudo usermod -aG docker lisk (3)
|1||create a new user|
|2||create docker group|
|3||add the user to docker group|
It is not essentially needed to set up a
lisk user, especially when you are runnign a local instance for development pruposes.
If you still want to do it, we recommend to create the user using the macOS GUI: https://support.apple.com/en-gb/guide/mac-help/mtusr001/mac
This section details how to install Lisk Core using pre-built binary packages. Once completed, you will have a functioning node on the Lisk Network. If you are looking to upgrade your current Lisk Core installation, please see the Upgrade Binary section.
The user was created in the Binary - Prerequisites Section. If you are already logged in to this user, please skip this step.
sudo -u lisk -i
This will configure the environment, download and install Lisk Core. Before proceeding, determine whether you wish to connect your node to the Testnet (Test Network) or the Mainnet (Main Network).
Download Lisk Core:
To connect your node to the Mainnet, run:
bash installLisk.sh install -r main
Download Lisk Core:
To connect your node to the Testnet, run:
bash installLisk.sh install -r test
You will be prompted for your installation directory, pressing enter will choose the default.
Next, you will be prompted, if you wish to synchronize from the Genesis block. If you answer `no', which is the default option, the node will download a recent snapshot of the database. This will be much faster than synching from the genesis block.
The installation may take a few minutes. Check the output of the script to verify that the installation was successful.
If you recognize an error, try to resolve it by analyzing the error output, otherwise, you can have a look at our Troubleshooting Section.
When the installation script has finished, navigate inside of the newly created folder
lisk-main(for Mainnet) or
You can verify that your Lisk node is up and running, by running the following command:
bash lisk.sh status
For further information and how to administer your Lisk node, please have a look at our Administration Section.
If you are not running Lisk locally, you will need to follow the Configuration - API document to enable access.
With all of the above steps complete you are ready to move on to the configuration documentation if you wish to enable forging or SSL, please see General Configuration.
Recommended: Set up a log rotation