How to install iris

The Latest version of IRIShub : v0.14.1

refer to :

Please replace <latest_iris_version> with v0.14.1 while using "git checkout" 

You can download the source code from github and compile it locally.

Configure Your Server

It's recommended that you run a validator node on Linux Server.

Recommended Configurations:

  1. 2 CPU
  2. Memory: 6GB
  3. Disk: 256GB SSD
  4. OS: Ubuntu 16.04 LTS
  5. Bandwidth: 20Mbps
  6. Allow all incoming connections on TCP port 26656 and 26657

Install Go


Go 1.12.1+ is required for the IRIShub.

Install go by following the official docs.

Remember to set your $GOPATH, $GOBIN, and $PATH environment variables, for example:

mkdir -p $HOME/go/bin
echo "export GOPATH=$HOME/go" >> ~/.bash_profile
echo "export GOBIN=$GOPATH/bin" >> ~/.bash_profile
echo "export PATH=$PATH:$GOBIN" >> ~/.bash_profile
source ~/.bash_profile

Verify that Go has been installed successfully:

go version


Quick install for macOS

Step 1: install brew

/usr/bin/ruby -e "$(curl -fsSL"

Step 2: install go with brew

brew install go

Compile Source Code

  • Get the code and compile Iris

After setting up Go correctly, you should be able to compile and run iris. Make sure that your server can access to because our project depends on some libraries provided by google.

  • To compile for testnet: Please checkout the latest version,refer to:
mkdir -p $GOPATH/src/
cd $GOPATH/src/
git clone
cd irishub && git checkout <latest_iris_version>
make get_tools
source scripts/
make all
  • To compile for betanet:
mkdir -p $GOPATH/src/
cd $GOPATH/src/
git clone
cd irishub && git checkout <latest_iris_version>
make get_tools
make all

If your environment variables have set up correctly, you should not get any errors by running the above commands. Now check your iris version.

$ iris version
$ iriscli version