Installing From Pip

Versioned Graphite releases can be installed via pip. When installing with pip, installation of Python package dependencies will automatically be attempted.

Note

In order to install Graphite-Web and Carbon, you must first install some development headers. In Debian-based distributions, this will require apt-get install python-dev libcairo2-dev libffi-dev build-essential, and in Red Hat-based distributions you will run yum install python-devel cairo-devel libffi-devel.

Installing in the Default Location

To install Graphite in the default location, /opt/graphite/, simply execute as root:

export PYTHONPATH="/opt/graphite/lib/:/opt/graphite/webapp/"
pip install https://github.com/graphite-project/whisper/tarball/master
pip install https://github.com/graphite-project/carbon/tarball/master
pip install https://github.com/graphite-project/graphite-web/tarball/master

Note

On RedHat-based systems using the python-pip package, the pip executable is named pip-python

Installing Carbon in a Custom Location

Installation of Carbon in a custom location with pip is similar to doing so from a source install. Arguments to the underlying setup.py controlling installation location can be passed through pip with the --install-option option.

See Installing Carbon in a Custom Location for details of locations and available arguments

For example, to install everything in /srv/graphite/:

pip install https://github.com/graphite-project/carbon/tarball/master --install-option="--prefix=/srv/graphite" --install-option="--install-lib=/srv/graphite/lib"

To install Carbon into the system-wide site-packages directory with scripts in /usr/bin and storage and configuration in /usr/share/graphite:

pip install https://github.com/graphite-project/carbon/tarball/master --install-option="--install-scripts=/usr/bin" --install-option="--install-lib=/usr/lib/python2.6/site-packages" --install-option="--install-data=/var/lib/graphite"

Installing Graphite-web in a Custom Location

Installation of Graphite-web in a custom location with pip is similar to doing so from a source install. Arguments to the underlying setup.py controlling installation location can be passed through pip with the --install-option option.

See Installing Graphite-web in a Custom Location for details on default locations and available arguments

For example, to install everything in /srv/graphite/:

pip install https://github.com/graphite-project/graphite-web/tarball/master --install-option="--prefix=/srv/graphite" --install-option="--install-lib=/srv/graphite/webapp"

To install the Graphite-web code into the system-wide site-packages directory with scripts in /usr/bin and storage configuration, and content in /usr/share/graphite:

pip install https://github.com/graphite-project/graphite-web/tarball/master --install-option="--install-scripts=/usr/bin" --install-option="--install-lib=/usr/lib/python2.6/site-packages" --install-option="--install-data=/var/lib/graphite"

Installing Ceres

Ceres is an alternative storage backend that some choose to use in place of the default Whisper backend.

pip install https://github.com/graphite-project/ceres/tarball/master