Installing the radixnode CLI
The most straightforward method of running a Radix node or gateway is by using the
radixnode CLI tool. The CLI tool works with Ubuntu, and can install dependencies, configure, and install your node and gateway. If can also be used to install monitoring tools, and to assist with maintenance actions on your node.
Its capabilities include:
Installing the Radix node as a docker instance or as a systemd install using
Configuring the node as a full node or validator node
Installing a Gateway as a docker instance
Setting up a Grafana dashboard for monitoring your node and/or gateway
Before continuing, you should work out what kind of node and/or gateway to install, and provision hosts to accomodate them. You will need to install the node CLI on each host that you wish to install on.
First, read the Node and Gateway Overview
If you need a Gateway API, check out the requirements for node and gateway
If you want to just run a node, check out the node requirements
If you want to run the Grafana monitoring stack, we recommend running another host with requirements here
This script has been tested on Linux Ubuntu 20.04, and requires Python version 3 to run. (If you don’t have an up-to-date version installed, then there’s a very good guide to upgrading Python here)
Windows is not supported
1. Update Packages
Start by ensuring that all the packages on the system are up to date by running the following command from the terminal:
sudo apt update -y
If it is not already installed as a standard package on your system, you will also need to install
sudo apt install wget
2. Download and install the radixnode CLI
Now download the
radixnode CLI from its GitHub repository.
Go to the URL https://github.com/radixdlt/node-runner/releases and look for the entry with the Latest release marker.
Copy the link for the latest release of
wgetthe link to download the script:
wget -O radixnode https://github.com/radixdlt/node-runner/releases/download/1.3.2/radixnode-ubuntu-20.04
Set the permissions on the script to executable.
chmod +x radixnode
Now move it to the
/usr/local/bin/directory, so it’s accessible from any other directory.
sudo mv radixnode /usr/local/bin
If you are installing the
You may also need to set the current user as the owner of the
Where to next … ?
Now the cli is installed, you can now use it to provision a node with docker containers or systemd.