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 with sudo apt install curl if 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

  1. 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.gpg
    
  2. Add the repository. The signed-by option 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.list
    
  3. Update the package lists, and install Reroute:

    sudo apt update
    sudo apt install reroute
    

    If apt update reports a signature error for rerouteholdings.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

  1. Import the key into rpm:

    sudo rpm --import https://rerouteholdings.llc/reroute/linux/reroute-archive-keyring.asc
    
  2. Add the repository:

    sudo curl -fsSLo /etc/yum.repos.d/reroute.repo https://rerouteholdings.llc/reroute/linux/rpm/reroute.repo
    

    The file turns on both checks: gpgcheck=1 for each package, and repo_gpgcheck=1 for the repository's index.

  3. Install Reroute:

    sudo dnf install reroute
    

    If 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

  1. 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 C7DB9B31A3E12B91F60E515AECD320C4511A7A82
    
  2. Add the repository at the end of /etc/pacman.conf. SigLevel = Required DatabaseRequired means pacman refuses both an unsigned package and an unsigned database:

    [reroute]
    SigLevel = Required DatabaseRequired
    Server = https://rerouteholdings.llc/reroute/linux/arch/$arch
    
  3. Sync 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, with packages.x86_64-linux.reroute, an overlay, and a NixOS module.
  • https://rerouteholdings.llc/reroute/releases/reroute.nix: the package by itself, for pkgs.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

  1. Download reroute.nix next to your configuration.nix:

    sudo curl -fsSLo /etc/nixos/reroute.nix https://rerouteholdings.llc/reroute/releases/reroute.nix
    
  2. In /etc/nixos/configuration.nix, add the package, and allow its license for Reroute only. The file's first line must name lib and pkgs, as in { config, lib, pkgs, ... }:. If you already have an environment.systemPackages list, add the package to it, and if you already set allowUnfreePredicate, add "reroute" to your list:

    environment.systemPackages = [ (pkgs.callPackage ./reroute.nix { }) ];
    nixpkgs.config.allowUnfreePredicate = pkg: builtins.elem (lib.getName pkg) [ "reroute" ];
    
  3. 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.gpg
    
  • Fedora:

    sudo rm /etc/yum.repos.d/reroute.repo
    
  • NixOS: 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 with sudo 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.