A full-node is a program that fully validates transactions and blocks of a blockchain. It is distinct from a light-node that only processes block headers and a small subset of transactions. Running a full-node requires more resources than a light-node but is necessary in order to be a validator. In practice, running a full-node only implies running a non-compromised and up-to-date version of the software with low network latency and without downtime.
Of course, it is possible and encouraged for users to run full-nodes even if they do not plan to be validators.
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 Desmos, 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'.
You can easily understand how using a pruning strategy of
nothing will use more disk space than
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|
|20 GB||40 GB|
|80 GB||120 GB|
|120 GB||> 240 GB|
A part from disk space, the following requirements should be met.
|Minimum CPU cores||Recommended CPU cores|
|Minimum RAM||Recommended RAM|
|4 GB||8 GB|
In order to run a fullnode, you need to build
desmos which requires
This process depends on your working environment.
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 systemsudo apt updatesudo apt upgrade # Install git, gcc and makesudo apt install git build-essential ufw curl jq snapd --yes # Install Go with Snapsudo snap install go --classic # Export environment variablesecho 'export GOPATH="$HOME/go"' >> ~/.profileecho 'export GOBIN="$GOPATH/bin"' >> ~/.profileecho 'export PATH="$GOBIN:$PATH"' >> ~/.profilesource ~/.profile
To install the required build tools, simple install Xcode from the Mac App Store.
Go on MacOS, the best option is to install with Homebrew. To do so, open
Terminal application and run the following command:
# Install Homebrew/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
If you don't know how to open a
Terminal, you can search it by typing
Spotlight(to access spotlight press cmd + spacebar simultaneously).
After Homebrew is installed, run
# Install software using Homebrewbrew install go git curl jq # Export environment variablesecho 'export GOPATH="$HOME/go"' >> ~/.profileecho 'export GOBIN="$GOPATH/bin"' >> ~/.profileecho 'export PATH="$GOBIN:$PATH"' >> ~/.profilesource ~/.profile
The software has not been tested on Windows If you are currently running a Windows PC, the following options should be considered:
- Switch to a Mac 👨💻.
- Wipe your hard drive and install a Linux system on your PC.
- Install a separate Linux system using VirtualBox
- Run a Linux instance on a cloud provider.
Note that is still possible to build and run the software on Windows but it may give you unexpected results and it may require additional setup to be done. If you insist to build and run the software on Windows, the best bet would be installing the Chocolatey package manager.
Once you have set up your environment correctly, you are now ready to install the Desmos software and start your full node.
In order to do so, you can follow our setup guide.