Installing the agent on Ubuntu
Last updated 2023-05-18
This guide explains how to install the Signal Sciences agent on Ubuntu.
Prerequisites
Before you begin, determine the version of Ubuntu you want to use.
Add the package repository
Begin the agent installation by adding the version of the Ubuntu package repository that you want to use.
Ubuntu 22.04 - Jammy
To add the Ubuntu 22.04 - Jammy package, run the following script:
1$ sudo apt-get update2$ sudo apt-get install -y apt-transport-https wget gnupg3$ wget -qO - https://apt.signalsciences.net/release/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/sigsci.gpg4$ sudo echo "deb [signed-by=/usr/share/keyrings/sigsci.gpg] https://apt.signalsciences.net/release/ubuntu/ jammy main" | sudo tee /etc/apt/sources.list.d/sigsci-release.list5$ sudo apt-get update
Ubuntu 20.04 - Focal
To add the Ubuntu 20.04 - Focal package, run the following script:
1$ sudo apt update2$ sudo apt-get install -y apt-transport-https wget3$ wget -qO - https://apt.signalsciences.net/release/gpgkey | sudo apt-key add -4$ sudo echo "deb https://apt.signalsciences.net/release/ubuntu/ focal main" | sudo tee /etc/apt/sources.list.d/sigsci-release.list && sudo apt-get update
Ubuntu 18.04 - Bionic
To add the Ubuntu 18.04 - Bionic package, run the following script:
1$ sudo apt update2$ sudo apt-get install -y apt-transport-https wget3$ wget -qO - https://apt.signalsciences.net/release/gpgkey | sudo apt-key add -4$ sudo echo "deb https://apt.signalsciences.net/release/ubuntu/ bionic main" | sudo tee /etc/apt/sources.list.d/sigsci-release.list && $ sudo apt-get update
Ubuntu 16.04 - Xenial
To add the Ubuntu 16.04 - Xenial package, run the following script:
1$ sudo apt-get install -y apt-transport-https wget2$ wget -qO - https://apt.signalsciences.net/release/gpgkey | sudo apt-key add -3$ sudo echo "deb https://apt.signalsciences.net/release/ubuntu/ xenial main" | sudo tee /etc/apt/sources.list.d/sigsci-release.list && $ sudo apt-get update
Ubuntu 14.04 - Trusty
To add the Ubuntu 14.04 - Trusty package, run the following script:
1$ sudo apt-get install -y apt-transport-https wget2$ wget -qO - https://apt.signalsciences.net/release/gpgkey | sudo apt-key add -3$ sudo echo "deb https://apt.signalsciences.net/release/ubuntu/ trusty main" | sudo tee /etc/apt/sources.list.d/sigsci-release.list && $ sudo apt-get update
Ubuntu 12.04 - Precise
To add the 12.04 - Precise package, run the following script:
1$ sudo apt-get install -y apt-transport-https wget2$ wget -qO - https://apt.signalsciences.net/release/gpgkey | sudo apt-key add -3$ sudo echo "deb https://apt.signalsciences.net/release/ubuntu/ precise main" | sudo tee /etc/apt/sources.list.d/sigsci-release.list && $ sudo apt-get update
Install and configure the Signal Sciences Agent package
Now that you've downloaded the Ubuntu package repository, you can install the Signal Sciences Agent package.
Run the following command to install the Signal Sciences Agent package.
$ sudo apt-get install sigsci-agent
Once the agent package is installed, you must create an agent configuration file and add the Agent Access Key and Agent Secret Key:
Create an empty agent configuration file in the following directory:
/etc/sigsci/agent.conf
.Log in to the Signal Sciences console.
From the Sites menu, select the site that you want to give the agent access to.
Click the Agents link in the site navigation bar. The agents page appears.
Click the View agent keys button. The agent keys window appears.
Click the Copy button to copy the Agent Access Key and Agent Secret Key to your clipboard.
Navigate to the agent configuration file and paste the Agent Access Key and Agent Secret Key into the file.
accesskeyid = "AGENTACCESSKEYHERE"secretaccesskey = "AGENTSECRETACCESSKEYHERE"Save the agent configuration file.
Start the Signal Sciences agent
Now that you've installed and configured the agent package, you can start the Signal Sciences agent.
For Ubuntu versions 18.04 and above, run the following command to start the Signal Sciences agent:
$ sudo service sigsci-agent start
For Ubuntu versions 15.04 through 17.10, run the following command to start the Signal Sciences agent:
$ sudo systemctl start sigsci-agent
For Ubuntu versions 14.04 and below, run the following command to start the Signal Sciences agent:
$ sudo start sigsci-agent
Optionally, enable the agent auto-update service. The service checks the Signal Sciences package downloads site for a new version of the agent and updates the agent when a new version is available.
Next steps
Explore our module options and install the Signal Sciences module.
Do not use this form to send sensitive information. If you need assistance, contact support. This form is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.