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

Lisk Core Docker Setup


This document will detail how to prepare a system to run Lisk Core as a Docker based container. In order to run Lisk in Docker a user must first install the Docker Engine. Additionally it is recommended to install Docker Compose for convenience.

Determine if your platform can run Docker.

Supported Platforms

Please refer to

Mac OS X

Please refer to
Please note that Docker for Mac already includes Docker Compose.
Install make using XCode


Please refer to
Please note that Docker for Windows includes Docker Compose.


Please refer to

To install Docker Compose, please refer to:

Important: Configure Docker, so it can be run without sudo rights:

Install make using your package manager. For example, use apt-get if running Ubuntu:

sudo apt-get install make

Open necessary ports

In order to connect to the desired network with Lisk Core , please ensure that the corresponding ports are open:

Network httpPort(HTTP) wsPort(TCP)
Mainnet 8000 8001
Testnet 7000 7001
Betanet 5000 5001
Devnet 4000 5000

These are the default ports for connecting with the network, these can be altered later in .env.


Get configuration and Makefile

Clone the Lisk Repository. It contains a directory docker with the following files:

  • Makefile
  • docker-compose.yml
  • .env.{network}

The .env-files are examples, where {network} stands for the lisk network you want to connect.

su - lisk # switch to lisk user
git clone # clone the repository
cd lisk/docker # navigate into docker directory

Set environment variables

In order to connect to the lisk network, the environment variables need to be set accordingly.
Copy the environment variables of the network you want to connect to:

cp .env.{network} .env

Coldstart application

make coldstart

You can then use docker-compose to see the status of your Lisk installation:

docker-compose ps

As next step, check out Docker Administration to learn how to manage your Node.