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
systemd
-
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 wget
:
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
radixnode
. -
wget
the 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.