Installing Smart Chain Software From Source Code
The basic Komodo software package includes two applications.
The komodod software application is the Smart Chain daemon that powers all Komodo blockchains.
The komodo-cli software application allows a developer to execute API calls to komodod via the command line.
Both of these software applications are installed in the ~/komodo/src/ directory as a part of any of the following installation procedures.
There are two methods available to install Smart Chain software.
You can download and unzip our pre-compiled binaries. This is the simplest method and requires no installation procedure.
For more information on this method, please see the link below.
Link to simple installations section for pre-compiled executables
You may also build Smart Chain software from source.
This is not required, but building from source is considered the best practice in a production environment, as this allows you to instantly update to the latest patches and upgrades.
-
Linux (easiest with a Debian-based distribution, such as Ubuntu)
- For Ubuntu, we recommend using only the 16.04 or 18.04 releases
-
64-bit Processor
-
Minimum 32GB HDD or SDD storage space
-
Minimum 4GB of free RAM (8GB+ recommended)
Verify that your system is up to date.
sudo apt-get update
sudo apt-get upgrade -y
sudo apt-get install build-essential pkg-config libc6-dev m4 g++-multilib autoconf libtool ncurses-dev unzip git zlib1g-dev wget curl bsdmainutils automake cmake clang ntp ntpdate nano -y
This action takes some time, depending on your Internet connection. Let the process run in the background.
Once completed, follow the steps below to install Komodo.
At some point during the installation process, you may see a warning, "libgmp headers missing". This can safely be ignored.
cd ~
git clone https://github.com/KomodoPlatform/komodo
cd komodo
./zcutil/fetch-params.sh
In the command below, the -j$(nproc) parameter instructs the script to utilize all available processors in your hardware.
Alternatively, you may instruct the script to use only a set number of processors. For example, -j8 instructs the script to use 8 processors, -j4 instructs the script to use 4 processors, etc.
./zcutil/build.sh -j$(nproc)
This script can take some time.
cd ~
mkdir .komodo
cd .komodo
nano komodo.conf
With the komodo.conf file open in the Nano text editor, add the following lines.
(Create your own rpcuser username and rpcpassword password.)
rpcuser=usernameChangeItToSomethingSecure
rpcpassword=passwordChangeItToSomethingSecure
txindex=1
bind=127.0.0.1
rpcbind=127.0.0.1
addnode=78.47.196.146
addnode=5.9.102.210
addnode=178.63.69.164
addnode=88.198.65.74
addnode=5.9.122.241
addnode=144.76.94.38
addnode=148.251.44.16
Press CTRL+O to save the changes.
Press CTRL+X to exit the Nano editor.
Start the komodod daemon. It will automatically begin syncing with the network.
cd ~
cd komodo/src
./komodod &
The & parameter in the last instruction above instructs the terminal to continue allowing you to enter commands within this terminal shell.
Enter the following command to "tail" the komodod daemon. The tail command allows you to view the debug.log file updates in real time.
tail -f ~/.komodo/debug.log
Ensure that your current working directory is in the default src directory.
cd ~/komodo/src/
You may now use the komodo-cli software to send API (RPC) calls to the komodod daemon.
For example:
./komodo-cli getinfo
This command returns the latest state information about the KMD blockchain and your wallet.dat file.
{
"version": 1000550,
"protocolversion": 170002,
"KMDversion": "0.1.0",
"notarized": 186670,
"notarizedhash": "000000308845da840ab9af6c1e09dc02f3118683df065b5ec00b05c9bd58cdae",
"notarizedtxid": "6723a10ef4fceab230d4245305d1ed2a916e435abb83269c20daad9bbefd3f0e",
"notarizedtxid_height": "mempool",
"notarized_confirms": 0,
"walletversion": 60000,
"balance": 0,
"interest": 0,
"blocks": 186773,
"longestchain": 308867,
"timeoffset": 0,
"tiptime": 1486411069,
"connections": 8,
"proxy": "",
"difficulty": 1624278.6287953,
"testnet": false,
"keypoololdest": 1482746526,
"keypoolsize": 101,
"paytxfee": 0.0,
"relayfee": 0.00001,
"errors": ""
}
When the blocks and longestchain values are equal to each other, your machine is in sync with the network.
We can not stress enough the importance of backing up your wallet.dat file.
On Linux, the file is located here: ~/.komodo/wallet.dat
One method to backup this file is to archive a copy of the file.
# Copy the file
cp -av ~/.komodo/wallet.dat ~/wallet.dat
# Rename file
mv ~/wallet.dat ~/2019-05-17-wallet_backup.dat
# To make archive
tar -czvf ~/2019-05-17-wallet_backup.dat.tgz ~/2019-05-17-wallet_backup.dat
# Move the final file to a secure location
- OSX (version > 10.11)
- Minimum 4GB of free RAM (8GB+ recommended)
Issue the following command in a terminal.
xcode-select --install
We use the software brew to install dependencies. If you have the latest version of brew installed already, you may skip this step.
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
Execute each command separately
brew update
brew upgrade
brew tap discoteq/discoteq; brew install flock
brew install autoconf autogen automake
brew install gcc@8
brew install binutils
brew install protobuf
brew install coreutils
brew install wget
git clone https://github.com/KomodoPlatform/komodo
cd komodo
./zcutil/fetch-params.sh
git checkout dev
./zcutil/build-mac.sh -j8
This can take some time.
While this process proceeds, open a new terminal for the next step.
Create the configuration file in the following directory:
~/Library/Application\ Support/Komodo
If the directory does not yet exist, create the directory.
mkdir ~/Library/Application\ Support/Komodo
Create the configuration file by entering the following commands in the terminal. Execute each line separately.
echo "rpcuser=komodouser" >> ~/Library/Application\ Support/Komodo/komodo.conf
echo "rpcpassword=`head -c 32 /dev/urandom | base64`" >> ~/Library/Application\ Support/Komodo/komodo.conf
echo "txindex=1" >> ~/Library/Application\ Support/Komodo/komodo.conf
echo "bind=127.0.0.1" >> ~/Library/Application\ Support/Komodo/komodo.conf
echo "rpcbind=127.0.0.1" >> ~/Library/Application\ Support/Komodo/komodo.conf
echo "addnode=5.9.102.210" >> ~/Library/Application\ Support/Komodo/komodo.conf
echo "addnode=78.47.196.146" >> ~/Library/Application\ Support/Komodo/komodo.conf
echo "addnode=178.63.69.164" >> ~/Library/Application\ Support/Komodo/komodo.conf
echo "addnode=88.198.65.74" >> ~/Library/Application\ Support/Komodo/komodo.conf
echo "addnode=5.9.122.241" >> ~/Library/Application\ Support/Komodo/komodo.conf
echo "addnode=144.76.94.38" >> ~/Library/Application\ Support/Komodo/komodo.conf
echo "addnode=148.251.44.16" >> ~/Library/Application\ Support/Komodo/komodo.conf
Once all processes are complete, run the komodod daemon.
cd ~/komodo/src
./komodod &
tail -f ~/Library/Application\ Support/Komodo/debug.log
cd ~/komodo/src
./komodo-cli getinfo
When the returned properties of blocks and longestchain are equal to each other, the daemon is finished syncing with the network.
We can not stress enough the importance of backing up your wallet.dat file.
On MacOS, the file is located here: ~/Library/Application\ Support/Komodo/wallet.dat
One method to backup this file is to archive a copy of the file.
# Copy the file
cp -av ~/Library/Application\ Support/Komodo/wallet.dat ~/wallet.dat
# Rename file
mv ~/wallet.dat ~/2019-05-17-wallet_backup.dat
# To make archive
tar -czvf ~/2019-05-17-wallet_backup.dat.tgz ~/2019-05-17-wallet_backup.dat
# Move the final file to a secure location
The Windows software for komodod and komodo-cli files are slightly different than their MacOS and Linux counterparts in two ways.
- The Windows software cannot be directly compiled on a Windows machine. Rather, the software must be compiled on a Linux machine (Ubuntu recommended), and then transferred to the Windows machine
- You can use a Virtual Machine-based installation of Ubuntu Linux, running on a Windows machine, as a solution
- The names of the software are
komodod.exeandkomodo-cli.exe
Once you have access to an Ubuntu machine and have access to a terminal with sudo privileges, you are prepared to continue the installation process.
sudo apt-get install build-essential pkg-config libc6-dev m4 g++-multilib autoconf libtool ncurses-dev unzip git python python-zmq zlib1g-dev wget libcurl4-gnutls-dev bsdmainutils automake curl libsodium-dev cmake mingw-w64
curl https://sh.rustup.rs -sSf | sh
source $HOME/.cargo/env
rustup target add x86_64-pc-windows-gnu
Execute:
sudo update-alternatives --config x86_64-w64-mingw32-gcc
After executing the above command, select the POSIX option.
Selection Path Priority Status
------------------------------------------------------------
0 /usr/bin/x86_64-w64-mingw32-gcc-win32 60 auto mode
1 /usr/bin/x86_64-w64-mingw32-gcc-posix 30 manual mode
* 2 /usr/bin/x86_64-w64-mingw32-gcc-win32 60 manual mode
Press <enter> to keep the current choice[*], or type selection number: 1
Execute:
sudo update-alternatives --config x86_64-w64-mingw32-g++
After executing the above command, select the POSIX option.
There are 2 choices for the alternative x86_64-w64-mingw32-g++ (providing /usr/bin/x86_64-w64-mingw32-g++).
Selection Path Priority Status
------------------------------------------------------------
0 /usr/bin/x86_64-w64-mingw32-g++-win32 60 auto mode
1 /usr/bin/x86_64-w64-mingw32-g++-posix 30 manual mode
* 2 /usr/bin/x86_64-w64-mingw32-g++-win32 60 manual mode
Press <enter> to keep the current choice[*], or type selection number: 1
git clone https://github.com/KomodoPlatform/komodo
cd komodo
./zcutil/fetch-params.sh
In the command below, you may instruct the script to use only a set number of processors. For example, -j8 instructs the script to use 8 processors, -j4 instructs the script to use 4 processors, etc.
./zcutil/build-win.sh -j8
This script can take some time. Once completed, you will find komodod.exe & komodo-cli.exe files inside the src directory.
Transfer these 2 executable files to your Windows computer and place the files in a new folder on the Desktop called kmd or any other location you prefer (remember the location and use that). For this guide we are using kmd directory on Desktop.
Open a command prompt for the following steps.
mkdir "%HOMEPATH%\AppData\Roaming\komodo"
notepad "%HOMEPATH%\AppData\Roaming\Komodo\komodo.conf"
When the software dialogue box opens, click Yes to create the komodo.conf file.
Copy the information below and paste it into Notepad.
rpcuser=usernameChangeItToSomethingSecure
rpcpassword=passwordChangeItToSomethingSecure
daemon=1
rpcallowip=127.0.0.1
rpcbind=127.0.0.1
server=1
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=148.251.44.16
After pasting, save and exit Notepad.
mkdir “%HOMEPATH%\AppData\Roaming\ZcashParams”
Download following files and move them into the new directory.
"%HOMEPATH%\Desktop\kmd\komodod.exe"
"%HOMEPATH%\Desktop\kmd\komodo-cli.exe" getinfo
We can not stress enough the importance of backing up your wallet.dat file.
On Windows, the file is located here: %HOMEPATH%\AppData\Roaming\Komodo\wallet.dat
One method to backup this file is to create a copy and archive it.