For the best viewing experience, please turn your phone to portrait mode.

Lisk Core Binary Installation

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.

Login to the Lisk user

The user was created in the Binary - Prerequisites Section. If you are already logged in to this user, please skip this step.

su - lisk

Execute the installation script

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).

Mainnet

Download Lisk Core:

wget https://downloads.lisk.io/lisk/main/installLisk.sh

To connect your node to the Mainnet, run:

bash installLisk.sh install -r main

Testnet

Download Lisk Core:

wget https://downloads.lisk.io/lisk/test/installLisk.sh

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 scripts output to verify that the installation was successful.

If you recognise an error, try to resolve it by analysing the error output, otherwise you can have a look at our Troubleshooting Section.

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.

Post-installation (optional)

Logrotate Setup

It is recommended to setup a log rotation for the logfile of Lisk Core.

Ubuntu

Ubuntu systems provide a service called logrotate for this purpose.
First make sure Logrotate is installed on your system:

logrotate --version

Next, go to the logrotate config directory and create a new logrotate file for Lisk Core:

cd /etc/logrotate.d
vim lisk

Inside of this file, define the parameters for the log rotation.

Example values:

/path/to/lisk/logs/*.log { 
        daily                   # daily rotation
        rotate 5                # keep the 5 most recent logs
        maxage 14               # remove logs that are older than 14 days
        compress                # compress old log files
        delaycompress           # compress the data, after it has been moved
        missingok               # if no logfile is present, ignore
        notifempty              # do not rotate empty log files
}

After customizing the config to fit your needs and saving it, you can test it by doing a dry run:

sudo logrotate /etc/logrotate.conf --debug