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.

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

Prepare your server for the agent by adding the repo and update the package lists.

sudo nano /etc/apt/sources.list.d/sd-agent.list

Paste in the following then press Ctrl+X to save:

deb all main

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

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.