Installation

System Requirements

When choosing a system to run RTRTR on, make sure you have 1GB of available memory and 1GB of disk space.

Binary Packages

Getting started with RTRTR is really easy by installing a binary package for either Debian and Ubuntu or for Red Hat Enterprise Linux (RHEL) and compatible systems such as Rocky Linux. Alternatively, you can run with Docker.

You can also build RTRTR from the source code using Cargo, Rust’s build system and package manager. Cargo lets you to run RTRTR on almost any operating system and CPU architecture. Refer to the Building From Source section to get started.

To install an RTRTR package, you need the 64-bit version of one of these Debian versions:

  • Debian Bullseye 11

  • Debian Buster 10

  • Debian Stretch 9

Packages for the amd64/x86_64 architecture are available for all listed versions. In addition, we offer armhf architecture packages for Debian/Raspbian Bullseye, and arm64 for Buster.

First update the apt package index:

sudo apt update

Then install packages to allow apt to use a repository over HTTPS:

sudo apt install \
  ca-certificates \
  curl \
  gnupg \
  lsb-release

Add the GPG key from NLnet Labs:

curl -fsSL https://packages.nlnetlabs.nl/aptkey.asc | sudo gpg --dearmor -o /usr/share/keyrings/nlnetlabs-archive-keyring.gpg

Now, use the following command to set up the main repository:

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/nlnetlabs-archive-keyring.gpg] https://packages.nlnetlabs.nl/linux/debian \
$(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/nlnetlabs.list > /dev/null

Update the apt package index once more:

sudo apt update

You can now install RTRTR with:

sudo apt install rtrtr

Configure RTRTR by editing /etc/rtrtr.conf and start it with:

sudo systemctl enable --now rtrtr

You can check the status of RTRTR with:

sudo systemctl status rtrtr

You can view the logs with:

sudo journalctl --unit=rtrtr

Updating

To update an existing RTRTR installation, first update the repository using:

sudo apt update

You can use this command to get an overview of the available versions:

sudo apt policy rtrtr

You can upgrade an existing RTRTR installation to the latest version using:

sudo apt --only-upgrade install rtrtr

Installing Specific Versions

Before every new release of RTRTR, one or more release candidates are provided for testing through every installation method. You can also install a specific version, if needed.

If you would like to try out release candidates of RTRTR you can add the proposed repository to the existing main repository described earlier.

Assuming you already have followed the steps to install regular releases, run this command to add the additional repository:

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/nlnetlabs-archive-keyring.gpg] https://packages.nlnetlabs.nl/linux/debian \
$(lsb_release -cs)-proposed main" | sudo tee /etc/apt/sources.list.d/nlnetlabs-proposed.list > /dev/null

Make sure to update the apt package index:

sudo apt update

You can now use this command to get an overview of the available versions:

sudo apt policy rtrtr

You can install a specific version using <package name>=<version>, e.g.:

sudo apt install rtrtr=0.1.1~rc2-1buster