Configuring Chronograf


Chronograf is the user interface and data visualization component of the InfluxData TICK stack and is designed to be used together with InfluxDB, Telegraf, and Kapacitor, but the minimum requirements are:

  • InfluxDB
    • available and running
    • authentication is enabled (auth-enabled option)
    • admin user has been created and is available
  • Kapacitor
    • optional, but needed to create and use alerts in Chronograf

Note: Run through the Getting Started tutorial for a quick start on configuring InfluxDB, Kapacitor, and Telegraf for use with Chronograf.

Starting the Chronograf service

Chronograf can be started using the default configuration options, but the environment variables and command line options let you configure OAuth 2.0 authentication and other options based on your requirements.

To start the Chronograf service:


  • sudo systemctl start chronograf
  • sudo systemctl start chronograf [OPTIONS] (where [OPTIONS] are any command line options, separated by spaces

Mac OS X

  • chronograf
  • chronograf [OPTIONS] (where [OPTIONS] are any command line options, separated by spaces

See Chronograf configuration options for details about configuration options, including command line options and corresponding environment variables.

Enabling security, multi-organization, and multi-user support

See Managing security for details on configuring authentication options for Chronograf using the JWT and OAuth 2.0 authentication protocols.

After you configure OAuth 2.0 authentication in Chronograf, you can use the multi-organization and multi-user support described in detail here:

This documentation is open source. See a typo? Please, open an issue.

Need help getting up and running? Get Support