search close

Ubuntu Agent Installation

access_time Updated Dec 6, 2022

IMPORTANT: Beginning January 31, 2023, the agent end-of-support policy will take effect. Per this policy, we will support agent versions that are under two years old. On a quarterly cadence, we will deprecate and no longer support agent versions that are older than two years. At the end of January, we will support Agent v4.16.0 and above. If you need help upgrading your agent to a supported version, contact securitysupport@fastly.com.

Add the package repository

Add the version of the Ubuntu package repository that you want to use:

Ubuntu 22.04 - Jammy

Run the following script:

sudo apt update
sudo apt-get install -y apt-transport-https wget
wget -qO - https://apt.signalsciences.net/release/gpgkey | sudo apt-key add -
sudo echo "deb https://apt.signalsciences.net/release/ubuntu/ jammy main" | sudo tee /etc/apt/sources.list.d/sigsci-release.list && sudo apt-get update

Ubuntu 20.04 - Focal

Run the following script:

sudo apt update
sudo apt-get install -y apt-transport-https wget
wget -qO - https://apt.signalsciences.net/release/gpgkey | sudo apt-key add -
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

Run the following script:

sudo apt update
sudo apt-get install -y apt-transport-https wget
wget -qO - https://apt.signalsciences.net/release/gpgkey | sudo apt-key add -
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

Run the following script:

sudo apt-get install -y apt-transport-https wget
wget -qO - https://apt.signalsciences.net/release/gpgkey | sudo apt-key add -
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

Run the following script:

sudo apt-get install -y apt-transport-https wget
wget -qO - https://apt.signalsciences.net/release/gpgkey | sudo apt-key add -
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

Run the following script:

sudo apt-get install -y apt-transport-https wget
wget -qO - https://apt.signalsciences.net/release/gpgkey | sudo apt-key add -
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 the Signal Sciences Agent package

  1. Run the following command:

    sudo apt-get install sigsci-agent
    
  2. Create an empty agent configuration file at /etc/sigsci/agent.conf.

  3. Add the Agent Access Key and Agent Secret Key into the agent configuration file at /etc/sigsci/agent.conf.

    1. Log in to the Signal Sciences console.

    2. Select a site if you have more than one site.

    3. Click Agents in the navigation bar. The agents page appears.

    4. Click View agent keys. The agent keys window appears.

      The ‘View agent keys’ button.

    5. Copy the Agent Access Key and Agent Secret Key.

      The agent keys window.

    6. Enter the Agent Access Key and Agent Secret Key into /etc/sigsci/agent.conf.

      accesskeyid = "AGENTACCESSKEYHERE"
      secretaccesskey = "AGENTSECRETACCESSKEYHERE"
      
  4. Start the Signal Sciences Agent.

    • Ubuntu 18.04 or higher

      sudo service sigsci-agent start
      
    • Ubuntu 15.04 through 17.10

      sudo systemctl start sigsci-agent
      
    • Ubuntu 14.04 and lower

      sudo start sigsci-agent
      

Next Steps

Install the Signal Sciences Module: