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.
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
gcc. On debian/ubuntu, install
- Cairo, including development files. On debian/ubuntu, install the
libffiwith development files,
- Pip, the Python package manager. On debian/ubuntu, install
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
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
- 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]