Install the Radix Node

Introduction

This section of the guide will walk you through the steps to complete a Docker versioned install of the Radix Node Runner package. Alternatively, Radix also provide the instructions for a Systemd install. The original installation instructions for both can be found here;

Pre-requisites

Port 30000/tcp opened for gossip

Port 443/tcp opened for NGINX

Install the CLI and then install the Docker Node version using the CLI

Radix have developed a CLI tool that facilitates an easier method for installing the package and for later querying the node. We will cover the querying elements in a later section.

Make sure all your system packages are up-to-date.

ensure wget is installed

Download the CLI package

Go to the URL https://github.com/radixdlt/node-runner/releases and look for the entry with the Latest release marker and copy the link to the latest release.

Set the permissions on the script to executable.

move it to the /usr/local/bin/ directory

Install Docker

log out of your ssh session and back in again

Configure NGINX

create and enter a strong NGINX admin password

set the NGINX password environment variable

add it to your session

do the same for a NGINX superadmin password

set the NGINX superadmin environment variable

add it to your session

Install and start the Radix Docker node

If you are building a validator node the enter a switch for -n fullnode. Alternatively you would enter -n archivenode for a non-validating archive node.

the second -t switch is for the seed node that you use to connect to the network. You would normally choose a node closest to your hosting region.

It will now go through a list of questions to configure your node

enter y at the prompt

as this is our first install enter n for the node keystore file.

Enter a strong password for your keystore file

Choose Y to configure the data directory.

Enter the absolute path to where you want to store the Radix DB

enter s for stokenet or m for mainnet

the install is now complete. Your docker yml file will be displayed where you can check the docker settings. Enter y to start your node

Your node is node installed. Before we move to the next section we'll confirm some basic checks

should return the following Json with your own tdx... node wallet address

check the software version is correct

check the node's health

other reponses may include

  • BOOTING - node is booting and not ready to accept requests

  • SYNCING - node is catching up the network

  • UP - node is in sync with consensus

  • STALLED - node is out of sync and not trying to sync with network, but network is still available.

  • OUT_OF_SYNC - node is out of sync and does not get updates from network (for example, connection to network is lost).

the node is now ready to be registered on the network.

Optimise Node

You need to install ansible first

Original Radix Docs

Docker Install using CLI https://docs.radixdlt.com/main/node/cli-install-node-docker.html

SystemD Install using CLI https://docs.radixdlt.com/main/node/cli-install-node-systemd.html

Last updated

Was this helpful?