Install the Radix Node
Last updated
Last updated
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;
Port 30000/tcp opened for gossip
Port 443/tcp opened for NGINX
The CLI has been developed with Ubuntu 20.04 and is not compatible with Windows
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
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
log out of your ssh session and back in again
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
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.
Asia Pacific (south-east)
Asia Pacific (south)
EU (west)
US (east)
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.
You need to install ansible first
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
