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

Lisk Core Source Administration

This section details how to manage a Source installation of Lisk Core.

Basic Commands


Check the status of the Lisk Core Node.

npx pm2 status lisk


Start Lisk Core.

npx pm2 start lisk


Stop Lisk Core.

npx pm2 stop lisk


Restart Lisk Core.

npx pm2 restart lisk


Remove Lisk Core process from the PM2 list.

npx pm2 delete lisk


In case you haven't done this during the Installation process, add your Lisk Core process to pm2 under the name lisk.

npx pm2 start --name lisk src/index.js -- --network [network]

Where [network] might be either testnet or mainnet.


Display Lisk Core logs in streaming.

npx pm2 logs

Command Line Options

There are plenty of options available that you can use to override configuration on runtime while starting Lisk Core.
How to overwrite config options from the Command Line:

LISK_NETWORK=[network] LISK_CONFIG_FILE=[config-path] LISK_ADDRESS=[address] LISK_WS_PORT=[port] npm start # Pass options as environment variables (recommended)
npm start -p [port] -a [address] -c [config-path] -n [network] # Pass options as flags

or with pm2, e.g.:

LISK_NETWORK=[network] LISK_CONFIG_FILE=[config-path] LISK_ADDRESS=[address] LISK_WS_PORT=[port] npx pm2 start lisk

You can pass any of devnet (default), alphanet, betanet, testnet or mainnet for the network option.
Each of these options can be appended on the command line. There are also ENV variables that can be utilized for this purpose.

Option ENV Variable Config Option Description
LISK_NETWORK Which configurations set to use, associated to lisk networks. Any of this option can be used devnet, alphanet, betanet, testnet and mainnet. Default value is devnet.
LISK_CONFIG_FILE Path the custom configuration file, which will override values of config/default/config.json
LISK_WS_PORT wsPort TCP port for P2P layer
LISK_ADDRESS address Listening host name or ip
LISK_FILE_LOG_LEVEL fileLogLevel Log level for file output
LISK_CONSOLE_LOG_LEVEL consoleLogLevel Log level for console output
LISK_CACHE_ENABLED cacheEnabled Enable or disable cache. Must be set to true/false
LISK_DB_NAME db.database PostgreSQL database name to connect to
LISK_DB_HOST PostgreSQL database host name
LISK_DB_PORT db.port PostgreSQL database port
LISK_DB_USER db.user PostgreSQL database username to connect to
LISK_DB_PASSWORD db.password PostgreSQL database password to connect to
LISK_REDIS_HOST Redis host name
LISK_REDIS_PORT redis.port Redis port
LISK_REDIS_DB_NAME redis.db Redis database name to connect to
LISK_REDIS_DB_PASSWORD redis.password Redis database password to connect to
LISK_PEERS peers.list Comma separated list of peers to connect to in the format,
LISK_API_PUBLIC api.access.public Enable or disable public access of http API. Must be set to true/false
LISK_API_WHITELIST api.access.whiteList Comma separated list of IPs to enable API access. Format,
LISK_FORGING_DELEGATES forging.delegates Comma separated list of delegates to load in the format publicKey|encryptedPassphrase,publicKey2|encryptedPassphrase2
LISK_FORGING_WHITELIST forging.access.whiteList Comma separated list of IPs to enable access to forging endpoints. Format,
Number of round for which take the snapshot. If none specified it will use the highest round available.


  • All ENV variables restricted with operating system constraint of ENV variable maximum length.
  • Comma separated lists will replace the original config values. e.g. If you specify LISK_PEERS, original peers.list specific to network will be replaced completely.

Utility scripts

There are couple of command line scripts that facilitate users of lisk to perform handy operations.
All scripts are are located under ./scripts/ directory and can be executed directly by node scripts/<file_name>.

Generate Config

This script will help you to generate unified version of configuration file for any network. Here is the usage of the script:

Usage: node scripts/generate_config.js [options]
 -h, --help               output usage information
-V, --version            output the version number
-c, --config [config]    custom config file
-n, --network [network]  specify the network or use LISK_NETWORK

Argument network is required and can by devnet, testnet, mainnet or any other network folder available under ./config directory.

Update Config

This script keeps track of all changes introduced in Lisk over time in different versions.
If you have one config file in any specific version and you want to make it compatible with other version of the Lisk, this script will do it for you.

Usage: node scripts/update_config.js [options] <input_file> <from_version> [to_version]
 -h, --help               output usage information
-V, --version            output the version number
-n, --network [network]  specify the network or use LISK_NETWORK
-o, --output [output]    output file path

As you can see from the usage guide, input_file andfrom_version are required.
If you skip to_version argument changes in config.json will be applied up to the latest version of Lisk Core.
If you do not specify --output path the final config.json will be printed to stdout.
If you do not specify --network argument you will have to load it from LISK_NETWORK env variable.


This script is really useful in development. It will initialize the components of Lisk and load these into nodejs REPL.

Usage: node scripts/console.js
 initApplication: Application initialization inside test environment started...
initApplication: Target database - lisk_dev
initApplication: Rewired modules available
initApplication: Fake onBlockchainReady event called
initApplication: Loading delegates...
initApplication: Delegates loaded from config file - 101
initApplication: Done
lisk-core [lisk_dev] >

Once you get the prompt, you can use modules, helpers, logic, db and config objects and play with these in REPL.

Rebuild from a snapshot

In some scenarios it is recommended to restore the blockchain from a snapshot. The command blocks below will perform this process. The URL can be substituted for another blockchain.db.gz snapshot file if desired.


npx pm2 stop lisk
dropdb lisk_main
createdb lisk_main
gunzip -fcq blockchain.db.gz | psql -d lisk_main
npx pm2 start lisk


npx pm2 stop lisk
dropdb lisk_test
createdb lisk_test
gunzip -fcq blockchain.db.gz | psql -d lisk_test
npx pm2 start lisk

Code documentation in Lisk Core

For code documentation, Lisk Core uses JSDoc.
With JSDoc generates a static HTML documentation site.
To build the documentation site, run the following command inside the lisk installation directory:

npm run docs:build

The JSDoc documentation is generated inside of docs/jsdoc/.

To host the documentation site (e.g. for easy access via a browser), use the following command:

npm run docs:serve

This will start a webserver, and the documentation will be accessible through the browser on port 8080, e.g. localhost:8080.
The process will be started inside the terminal. To stop the webserver again, hit CTRL + C.

For more information please have a look in the Contribution Guidelines for Lisk Core on Github.

What's next?