Tutorial - Installing EOS on Linux

Would you like to learn how to install EOS on Linux? In this tutorial, we are going to show you how to install EOS on a computer running Ubuntu Linux.

Hardware List:

The following section presents the list of equipment used to create this EOS tutorial.

Every piece of hardware listed above can be found at Amazon website.

EOS Related Tutorial:

On this page, we offer quick access to a list of tutorials related to EOS.IO.

List of Tutorials

Tutorial - Installing EOS on Linux

On the Linux console, use the following commands to set the correct timezone.

# dpkg-reconfigure tzdata

Install the Ntpdate package and set the correct date and time immediately.

# apt-get update
# apt-get install ntpdate
# ntpdate pool.ntp.br

Install the NTP service to keep our server updated.

# apt-get install ntp

Create a directory to the software and download the EOS package.

# mkdir /downloads
# cd /downloads
# git clone https://github.com/EOSIO/eos --recursive

Compile and install the EOS software.

# cd eos
# ./eosio_build.sh

The installation script will ask for your confirmation.

Enter the number 1 to confirm and wait for the EOS compilation to finish.

It can take a really long time.

Do you wish to install these packages?
1) Yes
2) No
#? 1

Near the end, your EOS installation may stop and present the following error message:

common.copy /root/opt/boost_1_66_0/lib/libboost_test_exec_monitor.a
...failed updating 54 targets...
...skipped 6 targets...
...updated 15206 targets...

Installation of boost libraries failed. 1

Exiting now.

If this happened to you, just run the installation script again, and everything will work this time.

# ./eosio_build.sh

The system should present messages while it compiles the EOS software.

[ 86%] Building CXX object src/mongocxx/test

[ 87%] Building CXX object src/mongocxx/test

[ 88%] Building CXX object src/mongocxx/test

After finishing the EOS compilation we need to manually start the Mongo database and test our installation.

# /root/opt/mongodb/bin/mongod -f /root/opt/mongodb/mongod.conf &
# export PATH=${HOME}/opt/mongodb/bin:$PATH
# cd /downloads/eos/build
# make test

You will see a lot of messages related to the EOS test.

Running tests...
Test project /downloads/eos/build
Start 1: test_cypher_suites
1/31 Test #1: test_cypher_suites ..................... Passed 0.02 sec
Start 2: validate_simple.token_abi
2/31 Test #2: validate_simple.token_abi .............. Passed 0.02 sec

After finishing the EOS test, use the following commands to finish the installation.

# cd /downloads/eos/build
# make install

Your EOS installation was finished successfully.

You can start your own single-node blockchain with this single command:

# nodeos -e -p eosio --plugin eosio::wallet_api_plugin --plugin eosio::chain_api_plugin --plugin eosio::account_history_api_plugin

At this point, Nodeos is running with a single producer, eosio.

You should see messages of block production:

* ------ NEW CHAIN ------ *
* - Welcome to EOSIO! - *
* ----------------------- *

eosio generated block 5987ac50... #1 @ 2018-04-19T03:45:55.000 with 0 trxs, lib: 0
eosio generated block 1142d387... #2 @ 2018-04-19T03:45:55.500 with 0 trxs, lib: 1
eosio generated block 78e6a7be... #3 @ 2018-04-19T03:45:56.000 with 0 trxs, lib: 2
eosio generated block 5e1e5990... #4 @ 2018-04-19T03:45:56.500 with 0 trxs, lib: 3