How To Install Komodo in Linux

From Komodo Platform Wiki
Jump to: navigation, search

Following these steps you can install and run Komodo core on Ubuntu Linux.

1 Install Dependencies[edit]

Enter the following in your terminal to install the dependencies required to build and run Komodo core. This has been tested in Ubuntu 14.04 (Trusty Tahr) and Ubuntu 16.04 (Xenial Xerus).

sudo apt-get update
sudo apt-get install build-essential pkg-config libcurl4-gnutls-dev libc6-dev libevent-dev m4 g++-multilib autoconf libtool libncurses5-dev unzip git python zlib1g-dev wget bsdmainutils automake libboost-all-dev libssl-dev libprotobuf-dev protobuf-compiler libqt4-dev libqrencode-dev libdb++-dev ntp ntpdate

2 Donwload the source code[edit]

Move to the folder where you want to store the Komodo software and download the source code repository:

git clone https://github.com/jl777/komodo

3 Build Komodo core[edit]

Enter the following to build the Komodo core executables:

cd komodo
./zcutil/fetch-params.sh
./zcutil/build.sh -j$(nproc)

This will default to use all the available CPU cores for the building process in order to speed it up. If you want to use a limited number of cores, you can replace $(nproc) with the number.

After the build process is completed, the Komodo binaries will be found in the komodo/src directory. If you want to install them in your system, from your current location you can do

sudo cp src/{komodod,komodo-cli} /usr/local/bin

4 Run Komodo core[edit]

4.1 Create the Komodo configuration file[edit]

The default location for the Komodo data directory is your user home folder. Here we will create this folder and edit a simple komodo.conf configuration file using nano, but of course you can use your favorite text editor.

cd ~
mkdir .komodo
nano .komodo/komodo.conf

In the file you can enter the following parameters:

rpcuser=komodorpc
rpcpassword=your_rpc_password
txindex=1
addnode=5.9.102.210
addnode=78.47.196.146
addnode=178.63.69.164
addnode=88.198.65.74
addnode=5.9.122.241
addnode=144.76.94.38
addnode=89.248.166.91

It is recommended that you replace the rpcuser and rpcpassword values with your personal values. The txindex=1 parameter enables indexing of transactions in your blockchain data (recommended and necessary for some features) and the addnode lines provide a default set of Komodo active nodes that will help to speed up your first blockchain download.

There's many other parameters that could be added by advanced users to this configuration file, following the Bitcoin configuration file syntax. You can find additional reference here.

4.2 Running and monitoring Komodo[edit]

If you installed the Komodo binaries in your system at the end of step 3, you can start the Komodo daemon by typing

komodod

in your command line. If you did not install them, you will need to either append to the command the whole path to where the komodod binary is located.

Starting the process in your current shell will display all the process output to the shell. If you want to have Komodo running in a sub-shell, so you can keep your main shell clean, running Komodo under a screen session is a good option. Make sure it is installed in your system by running

sudo apt-get install screen

Then you can start a screen session for Komodo with

screen -S komodo

Which will open a screen session where you can run komodod exclusively. Then you can return to your main shell by pressing Ctrl + A, then D, and re-attach to your Komodo screen session anytime with

screen -r komodo

to follow the Komodo server output. If you need to check the Komodo debug output to expand on any error messages, or to see details of the network activity including blockchain download progress, you can do

tail -f ~/.komodo/debug.log

To stop the Komodo server, you can enter

komodo-cli stop

Any RPC commands you want to send to your Komodo server need to be sent also using the komodo-cli executable. For reference about all the Komodo RPC commands, see the Komodo RPC Reference Guide.