Documentation

Configure Chronograf

Configure Chronograf by passing command line options when starting the Chronograf service. Or set custom default configuration options in the filesystem so they don’t have to be passed in when starting Chronograf.

Start the Chronograf service

Use one of the following commands to start Chronograf:

  • If you installed Chronograf using an official Debian or RPM package and are running a distro with systemd. For example, Ubuntu 15 or later.

    systemctl start chronograf
    
  • If you installed Chronograf using an official Debian or RPM package:

    service chronograf start
    
  • If you built Chronograf from source:

    $GOPATH/bin/chronograf
    

Set custom default Chronograf configuration options

Custom default Chronograf configuration settings can be defined in /etc/default/chronograf. This file consists of key-value pairs. See keys (environment variables) for Chronograf configuration options, and set values for the keys you want to configure.

HOST=0.0.0.0
PORT=8888
TLS_CERTIFICATE=/path/to/cert.pem
TOKEN_SECRET=MySup3rS3cretT0k3n
LOG_LEVEL=info

Note: /etc/default/chronograf is only created when installing the .deb or .rpm` package.

Set up security, organizations, and users

To set up security for Chronograf, configure:

After you configure OAuth 2.0 authentication, you can set up multiple organizations, roles, and users. For details, check out the following topics:


Was this page helpful?

Thank you for your feedback!


The future of Flux

Flux is going into maintenance mode. You can continue using it as you currently are without any changes to your code.

Read more

InfluxDB 3 Open Source Now in Public Alpha

InfluxDB 3 Open Source is now available for alpha testing, licensed under MIT or Apache 2 licensing.

We are releasing two products as part of the alpha.

InfluxDB 3 Core, is our new open source product. It is a recent-data engine for time series and event data. InfluxDB 3 Enterprise is a commercial version that builds on Core’s foundation, adding historical query capability, read replicas, high availability, scalability, and fine-grained security.

For more information on how to get started, check out: