Skip to content
This repository has been archived by the owner on Oct 15, 2022. It is now read-only.


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Install on DigitalOcean

Installing Graphite doesn't have to be difficult. The install script in synthesize is designed to make it brain-dead easy to install Graphite and related services onto a modern Linux distribution.

Synthesize is built to run on Ubuntu 18.04 LTS. It will not run on other Ubuntu releases or Linux distributions. The goal of this project is not to become an automation alternative to modern configuration management utilities (e.g. Chef or Puppet), but rather, to make it as easy as possible for the beginner Graphite user to get started and familiar with the project without having to learn a suite of other automation and/or infrastructure-related projects.

The resulting Graphite web interface listens only on https port 443 and has been configured to collect metrics specifically for helping profile the performance of your Graphite and Carbon services. It uses memcached for improved query performance, and Statsite for a fast, C-based implementation of the StatsD collector/aggregator.

Beginning with version 3.0.0 we've also incorporated the Grafana dashboard project, a modern and full-featured alternative to Graphite's built-in Composer and Dashboard interfaces. It also includes a default dashboard for monitoring Carbon's internal statistics.

⚠️ WARNING: You should not install Synthesize directly on your personal development system. It's strongly suggested that you use a VM or other temporary VPS instance for sandboxing Synthesize.



  • Vagrant, an Ubuntu 18.04 VM or a non-production server
  • Some mechanism for downloading Synthesize


⚠️ WARNING: Windows users may encounter provisioning issues. An apparent workaround is to run dos2unix on the install file before re-attempting provisioning.


$ cd synthesize
$ sudo ./install


Synthesize configures the following host ports to forward to the private vagrant box: :forwarded_port, guest: 443, host: 8443 :forwarded_port, guest: 8125, host: 8125, protocol: 'tcp' :forwarded_port, guest: 8125, host: 8125, protocol: 'udp' :forwarded_port, guest: 2003, host: 22003 :forwarded_port, guest: 2004, host: 22004 :forwarded_port, guest: 3000, host: 3030
$ cd synthesize
$ vagrant plugin install vagrant-vbguest
$ vagrant up



There is a superuser (Django) account that grants access to the administrative features in the backend Django database. The default credentials are:

  • username admin
  • password graphite_me_synthesize

These credentials can be changed with the following commands:

$ cd /opt/graphite/webapp/graphite
$ sudo python changepassword admin


Grafana includes a default user to start:

  • username admin
  • password admin


⚠️ WARNING: The following information is outdated for this experimental branch. If you attempt to run the upgrade script it will display a warning with further instructions to acknowledge the current experimental status and override the warning.

It's now possible to upgrade an existing Synthesize (e.g. Graphite 0.9.15) to the newest Graphite HEAD. Besides upgrading the Graphite components, it will also migrate the webapp database (graphite.db) to the newest fixtures version.

$ cd synthesize
$ sudo ./upgrade



$ cd synthesize
$ ./uninstall


$ cd synthesize
$ vagrant destroy


Synthesize is distributed under the MIT license.