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 --no-binary=:all: whisper
pip install --no-binary=:all: carbon
pip install --no-binary=:all: graphite-web
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 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"