Installing the RadixNode CLI

The most straightforward method of running a Radix node is by using the RadixNode CLI tool. 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, validator node, or archive node

  • Setting up a Grafana dashboard for monitoring your node

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 script from the RadixDLT 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.0.4/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 Docker node or a systemd node.