Requirements

Understanding pruning

In order to run a full node, different hardware requirements should be met based on the pruning strategy you would like to use.

Pruning is the term used to identify the periodic action that can be taken in order to free some disk space on your full node. This is done by removing old blocks data from the disk, freeing up space.

Inside the Realio Network, there are various types of pruning strategies that can be applied. The main ones are:

• default: the last 100 states are kept in addition to every 500th state; pruning at 10 block intervals

• nothing: all historic states will be saved, nothing will be deleted (i.e. archiving node)

• everything: all saved states will be deleted, storing only the current state; pruning at 10 block intervals (At the moment this option is not recommended as it can easily corrupt the database and the node will halt)

• custom: allow pruning options to be manually specified through 'pruning-keep-recent', 'pruning-keep-every', and 'pruning-interval'​

Hardware requirement

You can easily understand how using a pruning strategy of nothing will use more disk space than everything. For this reason, there are different disk space that we recommend based on the pruning strategy you choose:

Pruning strategy	Minimum disk space	Recommended disk space
everything	20 GB	60 GB
default	80 GB	160 GB
nothing	120 GB	> 300 GB

Apart from disk space, the following requirements should be met:

Minimum CPU cores	Recommended CPU cores
4	8

Minimum RAM	Recommended RAM
8 GB	16 GB

1. Setup your environment​

In order to run a full node, you need to build realio-networkd which requires Go, git, gcc and make installed.

This process depends on your working environment.

We officially support:

• darwin/arm64

• darwin/x86_64

• linux/arm64

• linux/amd64

OSX

To install the required build tools, simple install Xcode from the Mac App Store.

To install Go on MacOS, the best option is to install with Homebrew. To do so, open the Terminal application and run the following command:

# Install Homebrew
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

After Homebrew is installed, run

# Install software using Homebrew
brew install go git curl jq

# Export environment variables
echo 'export GOPATH="$HOME/go"' >> ~/.profile
echo 'export GOBIN="$GOPATH/bin"' >> ~/.profile
echo 'export PATH="$GOBIN:$PATH"' >> ~/.profile
source ~/.profile

Linux

The following example is based on Ubuntu (Debian) and assumes you are using a terminal environment by default. Please run the equivalent commands if you are running other Linux distributions.

# Update the system
sudo apt update
sudo apt upgrade

# Install git, gcc and make
sudo apt install git build-essential ufw curl jq snapd --yes

# Install Go with Snap
sudo snap install go --classic

# Export environment variables
echo 'export GOPATH="$HOME/go"' >> ~/.profile
echo 'export GOBIN="$GOPATH/bin"' >> ~/.profile
echo 'export PATH="$GOBIN:$PATH"' >> ~/.profile
source ~/.profile

The following example is based on Ubuntu (Debian) and assumes you are using a terminal environment by default. Please run the equivalent commands if you are running other Linux distributions.

# Update the system
sudo apt update
sudo apt upgrade

# Install git, gcc and make
sudo apt install git build-essential ufw curl jq snapd --yes

# Install Go with Snap
sudo snap install go --classic

# Export environment variables
echo 'export GOPATH="$HOME/go"' >> ~/.profile
echo 'export GOBIN="$GOPATH/bin"' >> ~/.profile
echo 'export PATH="$GOBIN:$PATH"' >> ~/.profile
source ~/.profile

2. Install the software​

Once you have set up your environment correctly, you are now ready to install the Realio Network software and start your full node.

In order to do so, you can follow our setup guide.