Public | Automated Build

Last pushed: a year ago
Short Description
Graphite web + carbon + whisper in a Docker container
Full Description


Graphite web + carbon + whisper in a Docker container

The existing images for Graphite all seemed to be either bloated, out-of-date, or built for use with certain extensions. This Docker image is an attempt to create a basic image that makes it very easy to get Graphite up-and-running quickly.

Quick start:

docker run \
  -p 8000:8000 \
  -v /local/storage:/opt/graphite/storage \
  -e GRAPHITE_WEB_SECRET_KEY='<secret key>' \

This will expose the Graphite web frontend and API at port 8000 on the host with the persistent storage mounted at /local/storage. Be sure to set the secret key to something better.

Volumes and ports

  • /opt/graphite/storage volume for persistent storage
  • Port 8000 for the graphite-web interface


Two processes are managed by supervisord:

  • gunicorn running graphite-web
  • carbon-cache


The example configurations are used in the following places:

  • conf/graphite.wsgi.example -> webapp/graphite/

Storage schemas

The retention schema that is used is 1 minute for 1 day, 5 minutes for 1 year,
and 1 hour for 5 years.

AMQP Configuration

Carbon can collect metrics via AMQP and can be configured to do using the following environment variables.

  • ENABLE_AMQP defaults to False
  • AMQP_VERBOSE defaults to False
  • AMQP_HOST defaults to localhost
  • AMQP_PORT defaults to 5672
  • AMQP_VHOST defaults to /
  • AMQP_USER defaults to guest
  • AMQP_PASSWORD defaults to guest
  • AMQP_EXCHANGE defaults to graphite
  • AMQP_METRIC_NAME_IN_BODY defaults to False

We added a simple based on the webapp/graphite/ example. The SECRET_KEY and email settings can be set using environment variables.

Extra functionality

There are a number of extra dependencies that can be installed to enable extra functionality in Graphite. We install only txAMQP for AMQP functionality. See here for more information.

Docker Pull Command

Comments (0)