Skip to content

Latest commit

 

History

History
90 lines (58 loc) · 2.62 KB

prerequisites_development_debian.md

File metadata and controls

90 lines (58 loc) · 2.62 KB
Raw

Lisk Service Development Dependencies for Debian

Note that those requirements are needed only if you want to build the project from sources, without support for Docker. This is useful if you are going to develop the project for your own blockchain or you cannot run Docker on your target machine. In other scenarios such as running a stable version of Lisk Service against the mainnet network, it is highly recommended to follow the Docker-based instruction.

Prerequisites

These programs and resources are required to install and run Lisk Service.

APT

In Ubuntu and its derivatives APT is the base package management application. Ensure your local APT registry is up-to-date.

apt update

Linux development dependencies

Install build-essential package alongside with several development tools.

  • GNU Tar is already installed with the standard distribution.
  • GNU Make and Git have to be installed explicitly.
sudo apt install build-essential git-core make

Redis

  1. Redis is used for caching temporary data.
sudo apt install redis-server

Note: During this step it is possible to change your port if you wish to have more Redis instances in the future. Remember to adjust the environment variables SERVICE_BROKER and SERVICE_CORE_REDIS accordingly.

MySQL

MySQL 5.7 is used for storing persistent data.

wget http://repo.mysql.com/mysql-apt-config_0.8.10-1_all.deb
sudo apt install ./mysql-apt-config_0.8.10-1_all.deb
sudo apt update
sudo apt install mysql-server
sudo mysql_secure_installation

Node.js

  1. Node.js 12.x serves as the underlying engine for code execution.
curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash -

sudo apt update
sudo apt install -y nodejs

Having Node.js installed makes it possible to install npm packages.

PM2

PM2 manages the node process for Lisk Service and handles log rotation.

npm install -g pm2

Alternative: quick one-step install

Copy and paste the following snippet to complete the installation in one step.

# Add external repositories
curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash -

# APT-based dependencies
sudo apt update
sudo apt install -y build-essential git make redis-server nodejs mysql-server
sudo mysql_secure_installation

# NPM-based dependencies
npm install -g pm2

Next steps

If you have all dependencies installed properly, you can start the build process.