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.

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.

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

  2. Copy the link for the latest release of radixnode.

  3. 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
  4. Set the permissions on the script to executable.

    chmod +x radixnode
  5. 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 radixnode CLI for use with an existing systemd node installation, then radixnode should instead be moved to your radixdlt directory where it will expect to find your existing key file.

You may also need to set the current user as the owner of the radixdlt directory.

Where to next … ?

Now the cli is installed, you can now use it to provision a node with docker containers or systemd.