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:
-
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/stable/2 stretch main
- Debian 10 (Buster)
- repository source url:
deb https://packages.redirection.io/deb/stable/2 buster main
- Ubuntu 16.04 (Xenial Xerus)
- repository source url:
deb https://packages.redirection.io/deb/stable/2 xenial main
- Ubuntu 18.04 LTS (Bionic Beaver)
- repository source url:
deb https://packages.redirection.io/deb/stable/2 bionic main
- Ubuntu 18.10 (Cosmic Cuttlefish)
- repository source url:
deb https://packages.redirection.io/deb/stable/2 cosmic main
- Ubuntu 19.04 (Disco Dingo)
- repository source url:
deb https://packages.redirection.io/deb/stable/2 disco main
- Ubuntu 19.10 (Eoan Ermine)
- repository source url:
deb https://packages.redirection.io/deb/stable/2 eoan main
- Ubuntu 20.04 LTS (Focal Fossa)
- repository source url:
deb https://packages.redirection.io/deb/stable/2 focal main
-
Install the
apt-transport-https
package:sudo apt-get install apt-transport-https
-
Import our apt repository key:
wget -q -O - https://packages.redirection.io/gpg.key | sudo apt-key add -
-
Add our Debian repository urls:
echo "deb https://packages.redirection.io/deb/stable/2 any main" | sudo tee -a /etc/apt/sources.list.d/packages_redirection_io_deb.list echo "deb https://packages.redirection.io/deb/stable/2 stretch main" | sudo tee -a /etc/apt/sources.list.d/packages_redirection_io_deb.list
-
Update the apt cache and install redirection.io's agent and nginx-module:
sudo apt update && sudo apt install redirectionio-agent libnginx-mod-redirectionio
-
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:
-
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 6
- repository url:
https://packages.redirection.io/rpm/stable/2/centos_6
- 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 6
- repository url:
https://packages.redirection.io/rpm/stable/2/centos_6
- config manager:
yum-config-manager
- package manager:
yum
-
Import the signature key:
wget -qO- https://packages.redirection.io/gpg.key -O /tmp/redirectionio-gpg.key && sudo rpm --import /tmp/redirectionio-gpg.key && rm /tmp/redirectionio-gpg.key
-
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
-
Install redirection.io's agent and nginx module:
sudo yum install redirectionio-agent sudo yum install libnginx-mod-redirectionio
-
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 🎉