TL;DR; Fast track

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 9 (Stretch)

   repository source url: deb https://packages.redirection.io/deb stretch main

   Debian 10 (Buster)

   repository source url: deb https://packages.redirection.io/deb buster main

   Ubuntu 16.04 (Xenial Xerus)

   repository source url: deb https://packages.redirection.io/deb xenial main

   Ubuntu 17.10 (Artful Aardvark)

   repository source url: deb https://packages.redirection.io/deb artful main

   Ubuntu 18.04 (Bionic Beaver)

   repository source url: deb https://packages.redirection.io/deb bionic main

   Ubuntu 18.10 (Cosmic Cuttlefish)

   repository source url: deb https://packages.redirection.io/deb cosmic main

2. Install the apt-transport-https package:

   sudo apt-get install apt-transport-https
   

3. Import our apt repository key:

   sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 24765BBD8E16EB44
   

4. Add our Debian repository urls:

   echo "deb https://packages.redirection.io/deb any main" | sudo tee -a /etc/apt/sources.list.d/packages_redirection_io_deb.list
   echo "deb https://packages.redirection.io/deb stretch main" | sudo tee -a /etc/apt/sources.list.d/packages_redirection_io_deb.list

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 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/centos_7

   config manager: yum-config-manager

   package manager: yum

   Centos 6

   repository url: https://packages.redirection.io/rpm/centos_6

   config manager: yum-config-manager

   package manager: yum

   Fedora 29

   repository url: https://packages.redirection.io/rpm/fedora_29

   config manager: dnf config-manager

   package manager: dnf

   Fedora 28

   repository url: https://packages.redirection.io/rpm/fedora_28

   config manager: dnf config-manager

   package manager: dnf

   RHEL 7

   repository url: https://packages.redirection.io/rpm/centos_7

   config manager: yum-config-manager

   package manager: yum

   RHEL 6

   repository url: https://packages.redirection.io/rpm/centos_6

   config manager: yum-config-manager

   package manager: yum

2. Import the signature key:

   sudo rpm --import 0x8E16EB44
   

3. Add our RPM repositories:

   sudo yum-config-manager --add-repo https://packages.redirection.io/rpm/any
   sudo yum-config-manager --add-repo https://packages.redirection.io/rpm/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 configuration and should see some logs within minutes 🎉