Installing From Pip

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

Note

In order to install carbon, you must install the development headers for Python and libffi. In Debian-based distributions, this will require apt-get install python-dev libffi-dev, and in Red Hat-based distributions you will run yum install python-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 -r https://raw.githubusercontent.com/graphite-project/carbon/0.9.13/requirements.txt
pip install -r https://raw.githubusercontent.com/graphite-project/graphite-web/0.9.13/requirements.txt
pip install whisper
pip install carbon
pip install graphite-web

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 carbon --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 carbon --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 graphite-web --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 graphite-web --install-option="--install-scripts=/usr/bin" --install-option="--install-lib=/usr/lib/python2.6/site-packages" --install-option="--install-data=/var/lib/graphite"