Installation¶
Debian / Ubuntu: native package¶
If you run Debian 8 or Ubuntu 14.04 LTS, you can use one of the available packages which provides a self-contained build of graphite-api. Builds are available on the releases page.
Once installed, Graphite-api should be running as a service and available on port 8888. The package contains all the optional dependencies.
Python package¶
Prerequisites¶
Installing Graphite-API requires:
- Python 2 (2.6 and above) or 3 (3.3 and above), with development files. On
debian/ubuntu, you’ll want to install
python-dev
. gcc
. On debian/ubuntu, installbuild-essential
.- Cairo, including development files. On debian/ubuntu, install the
libcairo2-dev
package. libffi
with development files,libffi-dev
on debian/ubuntu.- Pip, the Python package manager. On debian/ubuntu, install
python-pip
.
Global installation¶
To install Graphite-API globally on your system, run as root:
$ pip install graphite-api
Isolated installation (virtualenv)¶
If you want to isolate Graphite-API from the system-wide python environment, you can install it in a virtualenv.
$ virtualenv /usr/share/python/graphite
$ /usr/share/python/graphite/bin/pip install graphite-api
Extra dependencies¶
When you install graphite-api
, all the dependencies for running a Graphite
server that uses Whisper as a storage backend are installed. You can specify
extra dependencies:
- For Sentry integration:
pip install graphite-api[sentry]
. - For Cyanite integration:
pip install graphite-api[cyanite]
. - For Cache support:
pip install graphite-api[cache]
. You’ll also need the driver for the type of caching you want to use (Redis, Memcache, etc.). See the Flask-Cache docs for supported cache types.
You can also combine several extra dependencies:
$ pip install graphite-api[sentry,cyanite]