Debian / Ubuntu servers

The Server Density agent is delivered as an OS package for Debian & Ubuntu. The core agent is required for monitoring key metrics, with plugins installed as an additional package. Because the agent and plugins are installed as separate system packages, they'll be kept up to date as you update your OS normally. For non-LTS Ubuntu distributions, follow this guide.

Upgrading from agent v1? View the upgrade instructions.

Automatic installation

You can install the agent automatically using our shell script, or with our Puppet, Chef, Ansible and Salt modules. See automatically scaling and deploying the agent.


  • A device created in your server density account (Find out how to create a device in the UI)
  • sudo (root access) is required but the agent runs as its own user (sd-agent) once installed.
  • The agent requires sysstat to be installed to collect some key metrics. This will be installed as a dependency during installation.
  • Our repository requires that apt-transport-https be installed before adding to your sources list. You can install apt-transport-https with the command:
    apt-get install apt-transport-https

Add repository to apt, dependant on your version

Debian 9 - Stretch

echo "deb stretch main" | sudo tee /etc/apt/sources.list.d/sd-agent.list

Debian 10 - Buster

echo "deb buster main" | sudo tee /etc/apt/sources.list.d/sd-agent.list

Debian 11 - Bullseye

echo "deb bullseye main" | sudo tee /etc/apt/sources.list.d/sd-agent.list

Ubuntu 14.04 - Trusty

echo "deb trusty main" | sudo tee /etc/apt/sources.list.d/sd-agent.list

Ubuntu 16.04 - Xenial

echo "deb xenial main" | sudo tee /etc/apt/sources.list.d/sd-agent.list

Ubuntu 18.04 - Bionic

echo "deb bionic main" | sudo tee /etc/apt/sources.list.d/sd-agent.list

Ubuntu 20.04 - Focal

echo "deb focal main" | sudo tee /etc/apt/sources.list.d/sd-agent.list

Ubuntu 22.04 - Jammy

echo "deb jammy main" | sudo tee /etc/apt/sources.list.d/sd-agent.list

Download and install our key

curl -Ls | sudo apt-key add -

Update the package lists

sudo apt-get update -y

Install the agent

sudo apt-get install sd-agent

Configure the agent

sudo nano -w /etc/sd-agent/config.cfg

Enter the following values. Other settings are optional.


Restart the agent after any config changes:


sudo /etc/init.d/sd-agent restart


sudo systemctl restart sd-agent
sudo systemctl restart sd-agent-forwarder

You should now see data posting back to Server Density. If you're having trouble and need assistance, check out agent troubleshooting or get in touch


The agent can use a number of additional plugins, read information about plugins or check our plugin directory

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request


Monday  —  Friday.

10am  —  6pm UK.

Dedicated Support.