Installation of the agent

Installing the agent and getting redirection.io work is rather easy. This page will guide you through the redirection.io's agent installation steps.

Prerequisites and compatible platforms

Using redirection.io requires the ability to run redirection.io's agent on your server. In most of the cases, this means that you need a SSH access with root permissions. If your website uses a shared hosting without SSH access, it may seem that, unfortunately, you won't be able to use redirection.io's features.

Our agent works on Linux and FreeBSD.

Debian and APT-based distributions

  1. Install the apt-transport-https package:

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

    sudo apt-key adv --keyserver pgp.mit.edu --recv-keys 24765BBD8E16EB44
    
  3. Add the debian repository:

    echo "deb https://packages.redirection.io/deb any main" | sudo tee -a /etc/apt/sources.list.d/packages_redirection_io_deb.list
    
  4. Update the apt cache and install redirection.io's agent:

    sudo apt update && sudo apt install redirectionio-agent
    
  5. Once the agent is installed, edit its configuration file (in /etc/redirectionio/agent.yml - basically, you only need to change the instance name, which will help you identify the origin of logs collected by redirection.io), and start the service - this depends on the service manager used in your distribution. It can be for instance:

    sudo systemctl --system daemon-reload
    sudo systemctl start redirectionio-agent
    

You'll have to restart the service every time you change the agent configuration. If something goes wrong, if you need help or have questions, feel free to contact our support!

Red Hat and RPM-based distributions

  1. Import the signature key:

    sudo rpm --import 0x8E16EB44
    
  2. Add the repository:

    sudo yum-config-manager --add-repo https://packages.redirection.io/rpm/any
    
  3. Install redirection.io's agent:

    sudo yum install redirectionio-agent
    
  4. Once the agent is installed, edit its configuration file (in /etc/redirectionio/agent.yml - basically, you only need to change the instance name, which will help you identify the origin of logs collected by redirection.io), and start the service - this depends on the service manager used in your distribution. It can be for instance:

    sudo systemctl --system daemon-reload
    sudo systemctl start redirectionio-agent
    

Manual installation

In particular cases, a manual install might be the way to go.

  1. Download the last version of redirection.io's agent here: https://packages.redirection.io/dist/redirectionio-agent-latest_any.tar.gz
  2. Extract the archive, move files and edit the configuration according to your needs
  3. Run the agent

Windows

A Windows binary of the agent is available upon request, feel free to ask us!

Ansible

An Ansible role is available. You may install it using Ansible Galaxy:

ansible-galaxy install redirectionio.agent
Can't find your answer?