On this page
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 --no-binary=:all: https://github.com/graphite-project/whisper/tarball/master
pip install --no-binary=:all: https://github.com/graphite-project/carbon/tarball/master
pip install --no-binary=:all: https://github.com/graphite-project/graphite-web/tarball/master
Note
If your version of pip
is < 7.0.0 then no need to use --no-binary=:all:
parameter
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
© 2008–2012 Chris Davis
© 2011–2016 The Graphite Project
Licensed under the Apache License, Version 2.0.
https://graphite.readthedocs.io/en/latest/install-pip.html