Node how-tos

Prerequisites

## Node system requirements

Node system requirements

Please note that all system requirements listed below are presented in a Minimum/Recommended format.

Mainnet specs

Node typeRAMCPUStorageNetwork bandwidth
Full Node/Sentry Node32 GB/64 GB8 core/16 core4 TB/6 TB1 Gbit/s
Validator Node32 GB/64 GB8 core/16 core4 TB/6 TB1 Gbit/s
Archive Node (Erigon)64 GB16 core16 TB(io1 or above with at least 20k+ iops and RAID-0 based disk structure)1 Gbit/s

Testnet (Amoy) specs

Node typeRAMCPUStorageNetwork bandwidth
Full Node/Sentry Node8 GB/16 GB8 core/16 core1 TB/2 TB1 Gbit/s
Validator Node8 GB/16 GB8 core/16 core1 TB/2 TB1 Gbit/s
Archive Node (Erigon)16 GB16 core1 TB/2 TB (io1 or above with at least 20k+ iops and RAID-0 based disk structure)1 Gbit/s

Downloading the snapshot

It is recommended that you keep your snapshots handy before setting up the node. Link to the snapshot documentation here.

Open necessary ports

Sentry/full nodes

PortDescription
26656Heimdall service connects your node to another node’s Heimdall service using this port.
30303Bor service connects your node to another node’s Bor service using this port.
22For the validator to be able to SSH from wherever they are.
26660Prometheus port for Tendermint/Heimdall. Not required to be opened to the public. Only allow for the monitoring systems (Prometheus/Datadog).
7071Metric port for Bor. Only needs to be opened for the Monitoring system.
85458546,  1317Can be opened for Bor HTTP RPC, Bor WS RPC, and Heimdall API respectively; but only if really necessary.

Validator nodes

PortDescription
22Opening this to the public is not a good idea as the default SSH port 22 is prone to attacks. It is better to secure it by allowing it only in a closed network (VPN).
30303To be opened to only Sentry to which the validator is connected for Bor P2P discovery.
26656To be opened to only Sentry to which the validator is connected for Heimdall/Tendermint P2P discovery.
26660Prometheus port for Tendermint/Heimdall. Not required to be opened to the public. Only allow for the monitoring systems (Prometheus/Datadog).
7071Metric port for Bor. Only needs to be opened for the monitoring system.

Install RabbitMQ

Only for validator nodes

This step is only relevant for validator nodes.

Before setting up your validator node, it’s advisable to install the RabbitMQ service. You can use the following commands to set up RabbitMQ (if it’s not already installed):

sudo apt-get update
sudo apt install build-essential
sudo apt install erlang
wget https://github.com/rabbitmq/rabbitmq-server/releases/download/v3.10.8/rabbitmq-server_3.10.8-1_all.deb
sudo dpkg -i rabbitmq-server_3.10.8-1_all.deb

Connect to Ethereum RPC endpoint

Only for validator nodes

This step is only relevant for validator nodes.

Validator nodes need to connect to an Ethereum RPC endpoint. You may use your own Ethereum node, or utilize external infrastructure providers.

Mandatory checklist for validators

Please follow the below checklist in order to set up your validator node using binaries, Ansible, or packages.

ChecklistBinariesAnsiblePackages
Machines required2 Machines - sentry & validator3 Machines - local machinesentry and validator2 Machines - sentry & validator
Install Go packagesYesNoNo
Install PythonNoYes (only on the local machine where the Ansible Playbook runs)No
Install AnsibleNoYes (only on one machine)No
Install BashNoNoYes
Run Build EssentialYesNoNo
Node setupUsing binariesUsing AnsibleUsing packages
Edit on GitHub

Last updated on