Public | Automated Build

Last pushed: a year ago
Short Description
Standalone carbon relay image
Full Description

Graphite Setup

This reposistory is for images of graphite and the associated carbon daemons: carbon-cache and carbon-relay. It represents what we believe to be the best practices for running a graphite cluster.

Docker Hub locations






  • docker and docker-compose must be installed
  • rake -T will explain most everything

Example docker-compose.yml

The docker-compose.yml file is an example of a multi-node graphite cluster with each node running mulitple carbon-caches. It's described on Clustering Graphite - as the "Multiple nodes, multiple caches on each, multiple relays".

In the docker-compose.yml example, pretend there are two "nodes" a and b.

Each of those hosts is running:

  • one carbon-relay eg relaya and relayb. Each carbon-relay is pointed at the carbon-caches running on the same "node". It is using consistent-hashing for the relay method.
  • two carbon-caches: e.g. cachea1,cachea2,cacheb1,cacheb2. There should be a carbon-cache per core.
  • one graphite-web: e.g. weba and webb. Each graphite-web is only pointed at the carbon-relay running on the same "node".

We then run a separate web pointed at weba and webb and a "top" carbon-relay pointed at relaya and relayb.


Fork away, commit, and send a pull request.

Docker Pull Command
Source Repository