TL;DR; Fast track

This short documentation page will guide you through the steps required to get redirection.io work on your own infrastructure. If you use Cloudflare, you may also read our Cloudflare Workers integration help, which is even more straightforward.

Debian and apt-based distributions

If you use a Debian-like Linux distribution and want the easy way of trying / installing redirection.io, please use the following commands:

  1. Select your distribution

    In the next steps, please use the right values, depending on your distribution version:
    Debian 11 (Bullseye)
    repository source url: bullseye main
    Debian 10 (Buster)
    repository source url: buster main
    Debian 9 (Stretch)
    repository source url: stretch main
    Ubuntu 16.04 LTS (Xenial Xerus)
    repository source url: xenial main
    Ubuntu 18.04 LTS (Bionic Beaver)
    repository source url: bionic main
    Ubuntu 20.04 LTS (Focal Fossa)
    repository source url: focal main
    Ubuntu 22.04 LTS (Jammy Jellyfish)
    repository source url: jammy main
  2. Install the apt-transport-https package:

    sudo apt-get install apt-transport-https
    
  3. Import our apt repository key:

    sudo mkdir -p /etc/apt/keyrings
    wget -qO- https://packages.redirection.io/gpg.key | sudo tee /etc/apt/keyrings/redirectionio-archive-keyring.asc
    
  4. Add our Debian repository urls:

    echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/redirectionio-archive-keyring.asc] https://packages.redirection.io/deb/stable/2 any main" | sudo tee -a /etc/apt/sources.list.d/packages_redirection_io_deb.list > /dev/null
    echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/redirectionio-archive-keyring.asc] https://packages.redirection.io/deb/stable/2 bullseye main" | sudo tee -a /etc/apt/sources.list.d/packages_redirection_io_deb.list > /dev/null
  5. Update the apt cache and install redirection.io's agent and nginx-module:

    sudo apt update && sudo apt install redirectionio-agent libnginx-mod-redirectionio
    
  6. reload nginx

    sudo systemctl reload nginx
    

You're done! redirection.io is installed, up and running. You can go on with redirection.io's nginx configuration and should see some logs within minutes πŸŽ‰

Red Hat and rpm-based distributions

If you use a Red Hat/CentOS-like Linux distribution and want the easy way of trying / installing redirection.io, please use the following commands:

  1. Select your distribution

    In the next steps, please use the right values, depending on your distribution version:
    Centos 7
    repository url: https://packages.redirection.io/rpm/stable/2/centos_7
    config manager: yum-config-manager
    package manager: yum
    Centos 8
    repository url: https://packages.redirection.io/rpm/stable/2/centos_8
    config manager: yum-config-manager
    package manager: yum
    RHEL 7
    repository url: https://packages.redirection.io/rpm/stable/2/centos_7
    config manager: yum-config-manager
    package manager: yum
    RHEL 8
    repository url: https://packages.redirection.io/rpm/stable/2/centos_8
    config manager: yum-config-manager
    package manager: yum
  2. Import the signature key:

    sudo rpm --import https://packages.redirection.io/gpg.key
    
  3. Add our RPM repositories:

    sudo yum-config-manager --add-repo https://packages.redirection.io/rpm/stable/2/any
    sudo yum-config-manager --add-repo https://packages.redirection.io/rpm/stable/2/centos_7
  4. Install redirection.io's agent and nginx module:

    sudo yum install redirectionio-agent
    sudo yum install libnginx-mod-redirectionio
  5. reload the nginx service, for instance:

    sudo systemctl reload nginx
    

You're done! redirection.io is installed, up and running. You can go on with redirection.io's nginx configuration and should see some logs within minutes πŸŽ‰

This page has been updated on May 30th, 2022.
Can't find your answer?