Installing the babylonnode CLI

The most straightforward method of running a Radix node or gateway is by using the babylonnode CLI tool. The CLI tool works with Ubuntu, and can install dependencies, configure, and install your node and gateway. It 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

  • 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 22.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 babylonnode CLI

Now download the babylonnode CLI from its GitHub repository.

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

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

  3. Download the binary using wget. This is an example link to download the binary for ubuntu-22.04:

    wget -O babylonnode https://github.com/radixdlt/babylon-nodecli/releases/download/2.1.0/babylonnode-ubuntu-22.04

By using the babylonnode CLI you agree to the End User License Agreement. You can find all terms and conditions here.

  1. Set the permissions on the script to executable.

    chmod +x babylonnode
  2. Now move it to the /usr/local/bin/ directory, so it’s accessible from any other directory.

    sudo mv babylonnode /usr/local/bin

If you are installing the babylonnode CLI for use with an existing systemd node installation, then babylonnode 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.