Install Reroute on Linux
This page shows how to install Reroute from our package repositories, so your system's package manager installs Reroute and keeps it up to date with the rest of your software. Every repository is signed with the Reroute Linux signing key, and your package manager checks that signature before it installs anything.
Reroute also checks for updates on its own and offers to install them, with your password. Both ways install the same signed packages, so you can use either.
Before you begin
You need:
- A 64-bit Intel or AMD computer (x86_64). There are no Arm packages yet.
- One of these systems: Debian 12 or later, Ubuntu 22.04 or later, Fedora 37 or later, or Arch Linux. Systems based on them, such as Linux Mint, use the same steps, but we don't test them. For NixOS, see NixOS: it uses a Nix package instead of a repository.
- An account that can run
sudo. curl, to download the key. On Debian and Ubuntu, install it withsudo apt install curlif you don't have it.
The signing key
The repositories and the packages in them are signed with this key:
Reroute Holdings LLC <releases@rerouteholdings.llc>
RSA 4096, no expiry date
Fingerprint: C7DB 9B31 A3E1 2B91 F60E 515A ECD3 20C4 511A 7A82
The key is published at https://rerouteholdings.llc/reroute/linux/reroute-archive-keyring.asc, and as a binary keyring for apt at https://rerouteholdings.llc/reroute/linux/reroute-archive-keyring.gpg. To compare its fingerprint with the one above before you trust it, run:
curl -fsSL https://rerouteholdings.llc/reroute/linux/reroute-archive-keyring.asc | gpg --show-keys
The output shows the fingerprint as one string of 40 characters, without spaces: C7DB9B31A3E12B91F60E515AECD320C4511A7A82.
Debian and Ubuntu
Download the key into
/usr/share/keyrings:sudo curl -fsSLo /usr/share/keyrings/reroute-archive-keyring.gpg https://rerouteholdings.llc/reroute/linux/reroute-archive-keyring.gpgAdd the repository. The
signed-byoption means apt trusts this key for this repository only:echo 'deb [signed-by=/usr/share/keyrings/reroute-archive-keyring.gpg] https://rerouteholdings.llc/reroute/linux/apt stable main' | sudo tee /etc/apt/sources.list.d/reroute.listUpdate the package lists, and install Reroute:
sudo apt update sudo apt install rerouteIf
apt updatereports a signature error forrerouteholdings.llc, don't continue. Check that the key file downloaded in step 1 has the fingerprint above.
Later updates come with sudo apt update && sudo apt upgrade, like the rest of your system.
Fedora
Import the key into rpm:
sudo rpm --import https://rerouteholdings.llc/reroute/linux/reroute-archive-keyring.ascAdd the repository:
sudo curl -fsSLo /etc/yum.repos.d/reroute.repo https://rerouteholdings.llc/reroute/linux/rpm/reroute.repoThe file turns on both checks:
gpgcheck=1for each package, andrepo_gpgcheck=1for the repository's index.Install Reroute:
sudo dnf install rerouteIf dnf asks to import the key, check that the fingerprint it shows matches the one above, then enter
y.
Later updates come with sudo dnf upgrade.
Arch Linux
Download the key, add it to pacman's keyring, and sign it locally, so pacman trusts it:
curl -fsSLo /tmp/reroute-archive-keyring.asc https://rerouteholdings.llc/reroute/linux/reroute-archive-keyring.asc sudo pacman-key --add /tmp/reroute-archive-keyring.asc sudo pacman-key --lsign-key C7DB9B31A3E12B91F60E515AECD320C4511A7A82Add the repository at the end of
/etc/pacman.conf.SigLevel = Required DatabaseRequiredmeans pacman refuses both an unsigned package and an unsigned database:[reroute] SigLevel = Required DatabaseRequired Server = https://rerouteholdings.llc/reroute/linux/arch/$archSync the databases, and install Reroute:
sudo pacman -Syu reroute
Later updates come with sudo pacman -Syu. On Arch, the package is a repackaged build of the Debian package, not built from source.
NixOS
On NixOS, Reroute comes as a Nix package that installs the official .deb, with its checksum, for x86_64 only. The newest release's files are always at these two addresses, and each release's own copies are in its folder, such as https://rerouteholdings.llc/reroute/releases/0.2.0-rc.6/:
https://rerouteholdings.llc/reroute/releases/reroute-nix.tar.gz: a flake, withpackages.x86_64-linux.reroute, an overlay, and a NixOS module.https://rerouteholdings.llc/reroute/releases/reroute.nix: the package by itself, forpkgs.callPackage.
Reroute's emoji (Mutant Standard) are licensed CC BY-NC-SA 4.0, which nixpkgs counts as unfree. The flake allows that license for Reroute only. With reroute.nix, you allow it yourself, as shown in the steps.
Reroute can't update itself on NixOS, because the Nix store is read-only. Its settings say that this copy can't update itself, and you update it with Nix instead.
Install with the flake
This needs flakes turned on (the nix-command and flakes experimental features).
To install Reroute in your user profile, run:
nix profile install https://rerouteholdings.llc/reroute/releases/reroute-nix.tar.gz
When a new release is out, run nix profile upgrade --all.
If your NixOS configuration is a flake, add Reroute as an input instead, and turn on its module:
{
inputs.reroute.url = "https://rerouteholdings.llc/reroute/releases/reroute-nix.tar.gz";
outputs = { nixpkgs, reroute, ... }: {
nixosConfigurations.YOUR_HOST = nixpkgs.lib.nixosSystem {
system = "x86_64-linux";
modules = [
./configuration.nix
reroute.nixosModules.default
{ programs.reroute.enable = true; }
];
};
};
}
When a new release is out, run nix flake update reroute, then sudo nixos-rebuild switch.
Install with configuration.nix
Download
reroute.nixnext to yourconfiguration.nix:sudo curl -fsSLo /etc/nixos/reroute.nix https://rerouteholdings.llc/reroute/releases/reroute.nixIn
/etc/nixos/configuration.nix, add the package, and allow its license for Reroute only. The file's first line must namelibandpkgs, as in{ config, lib, pkgs, ... }:. If you already have anenvironment.systemPackageslist, add the package to it, and if you already setallowUnfreePredicate, add"reroute"to your list:environment.systemPackages = [ (pkgs.callPackage ./reroute.nix { }) ]; nixpkgs.config.allowUnfreePredicate = pkg: builtins.elem (lib.getName pkg) [ "reroute" ];Rebuild your system:
sudo nixos-rebuild switch
To update, download the new reroute.nix with the same command as in step 1, then rebuild.
What the signatures cover
| System | What's signed | What your package manager checks |
|---|---|---|
| Debian and Ubuntu | The repository's InRelease file, which lists the checksums of the package index |
The signature on InRelease, then each checksum down to the package you install |
| Fedora | The repository's repomd.xml, and each .rpm file |
The signature on repomd.xml, then the signature on each package |
| Arch Linux | The reroute database, and each package |
The signature on the database, then the signature on each package |
The repositories keep the newest three versions of Reroute.
Remove the repository
To stop getting Reroute from the repository, remove the files you added. Reroute itself stays installed until you remove it with your package manager.
Debian and Ubuntu:
sudo rm /etc/apt/sources.list.d/reroute.list /usr/share/keyrings/reroute-archive-keyring.gpgFedora:
sudo rm /etc/yum.repos.d/reroute.repoNixOS: Reroute doesn't use a repository there. To remove Reroute itself, run
nix profile remove reroute, or delete it from your configuration and rebuild.Arch Linux: delete the
[reroute]section from/etc/pacman.conf, then remove the key withsudo pacman-key --delete C7DB9B31A3E12B91F60E515AECD320C4511A7A82.
Other systems
For other distributions, download the .deb, .rpm, or Arch package from the Reroute download page, or use the Gentoo overlay there.