A simple way to get started is by pulling down our installer script.

For Debian-based systems, including Ubuntu:

curl -s | sudo sh


or for RHEL-based systems:

curl -s | sudo sh

This can also be easily tested with Docker, among other virtual environments. Using Docker, pull down the installer script inside an Ubuntu container (ideal on an ubuntu:16.04 image):

  docker pull ubuntu:16.04
  docker run -it ubuntu:16.04
  apt-get update
  apt-get install -y curl sudo
  curl -s | sudo sh
  /opt/hg-agent/bin/config --api-key YOUR-API-KEY
  /opt/hg-agent/bin/supervisord --nodaemon --configuration /etc/opt/hg-agent/supervisor.conf

If you would like to set up installation and configuration via Puppet, Chef or a similar configuration management system, see our repository install instructions.

Once your agent is sending metrics, you will find it in your Agent list, along with a link to an auto-generated Base Metrics dashboard named Hosted Graphite Agent (Base).



We support the following stable OS releases on 64-bit machines:

  • CentOS 6 and later (covering the RedHat family);
  • Debian Wheezy and later;
  • Ubuntu 12.04 LTS and later.

These should cover most installs on RHEL, CentOS, Amazon Linux, and Debian/Ubuntu family platforms.