CentOS / Red Hat servers

The Server Density agent is delivered as an RPM package for RHEL based distros including CentOS, CloudLinux, Oracle, Red Hat and Scientific Linux. The core agent is required for monitoring key metrics, with plugins installed as an additional package. The agent and plugins will be kept up to date in-line with your own policy (nightly, weekly, manually etc).

Upgrading from agent v1? View the upgrade instructions.

Oracle 5 and Scientific Linux 5 are not officially supported.

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.

Add repository to yum

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

sudo nano /etc/yum.repos.d/serverdensity.repo

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

name=Server Density Repository for Enterprise Linux $releasever - $basearch

Install the Repository Key

CentOS 5:

curl -Ls https://archive.serverdensity.com/sd-packaging-el5-public.key | sudo tee /etc/pki/rpm-gpg/RPM-GPG-KEY-serverdensity

CentOS 6+:

curl -Ls https://archive.serverdensity.com/sd-packaging-public.key | sudo tee /etc/pki/rpm-gpg/RPM-GPG-KEY-serverdensity

Install the EPEL repo (CentOS / RHEL 5 only)

sudo yum install epel-release

Install the agent

sudo yum 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.