Documentation

Manage Chronograf organizations

On this page:

About Chronograf organizations

Note: Support for organizations and user roles is available in Chronograf 1.4 or later. First, OAuth 2.0 authentication must be configured (if it is, you’ll see the Chronograf Admin tab on the Admin menu). For more information, see managing security.

For information about the new user roles and SuperAdmin permission, see Managing Chronograf users.

A Chronograf organization is a collection of Chronograf users who share common Chronograf-owned resources, including dashboards, InfluxDB connections, and Kapacitor connections. Organizations can be used to represent companies, functional units, projects, or teams. Chronograf users can be members of multiple organizations.

Note: Only users with SuperAdmin permission can manage organizations. Admins, editors, viewers, and members cannot manage organizations unless they have SuperAdmin permission.

Use the default organization

Note: The default organization can be used to support Chronograf as configured in versions earlier than 1.4. Upon upgrading, any Chronograf resources that existed prior to 1.4 automatically become owned by the Default organization.

Upon installation, the default organization is ready for use and allows Chronograf to be used as-is.

Create organizations

Your company, organizational units, teams, and projects may require the creation of additional organizations, beyond the Default organization. Additional organizations can be created as described below.

To create an organization:

Required permission: SuperAdmin

  1. In the Chronograf navigation bar, click Admin (crown icon) > Chronograf to open the Chronograf Admin page.
  2. In the All Orgs tab, click Create Organization.
  3. Under Name, click on “Untitled Organization” and enter the new organization name.
  4. Under Default Role, select the default role for new users within that organization. Valid options include member (default), viewer, editor, and admin.
  5. Click Save.

Configure organizations

Required permission: SuperAdmin

You can configure existing and new organizations in the Organizations tab of the Chronograf Admin page as follows:

  • Name: The name of the organization. Click on the organization name to change it.

    Note: You can change the Default organization’s name, but that organization will always be the default organization.

  • Public: [Default organization only] Indicates whether a user can authenticate without being explicitly added to the organization. When Public is toggled to Off, new users cannot authenticate into your Chronograf instance unless they have been explicitly added to the organization by an administrator.

    Note: All organizations other than the Default organization require users to be explicitly added by an administrator.

  • Default Role: The role granted to new users by default when added to an organization. Valid options are member (default), viewer, editor, and admin.

See the following pages for more information about managing Chronograf users and security:

Map organizations

To create an organization mapping:

Required permission: SuperAdmin

  1. In the Chronograf navigation bar, select Admin (crown icon) > Chronograf to open the Chronograf Admin page.
  2. Click the Org Mappings tab to view a list of organization mappings.
  3. To add an organization mapping, click the Create Mapping button. A new row is added to the listing.
  4. In the new row, enter the following:
  • Scheme, select oauth2.
  • Provider: Enter the provider. Valid values include Google and GitHub.
  • Provider Org: [Optional] Enter the email domain(s) you want to accept.
  • Organization: Select the organization that can use this authentication provider.

To remove an organization mapping:

Required permission: SuperAdmin

  1. In the Chronograf navigation bar, select Admin (crown icon) > Chronograf to open the Chronograf Admin page.
  2. Click the Org Mappings tab to view a list of organization mappings.
  3. To remove an organization mapping, click the Delete button at the end of the mapping row you want to remove, and then confirm the action.

Remove organizations

When an organization is removed:

  • Users within that organization are removed from that organization and will be logged out of the application.
  • All users with roles in that organization are updated to no longer have a role in that organization
  • All resources owned by that organization are deleted.

To remove an organization:

Required permission: SuperAdmin

  1. In the navigation bar of the Chronograf application, select Admin (crown icon) > Chronograf to open the Chronograf Admin page.
  2. Click the All Orgs tab to view a list of organizations.
  3. To the right of the the organization that you want to remove, click the Remove button (trashcan icon) and then confirm by clicking the Save button.

Was this page helpful?

Thank you for your feedback!


Introducing InfluxDB Clustered

A highly available InfluxDB 3.0 cluster on your own infrastructure.

InfluxDB Clustered is a highly available InfluxDB 3.0 cluster built for high write and query workloads on your own infrastructure.

InfluxDB Clustered is currently in limited availability and is only available to a limited group of InfluxData customers. If interested in being part of the limited access group, please contact the InfluxData Sales team.

Learn more
Contact InfluxData Sales

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.

Flux is going into maintenance mode and will not be supported in InfluxDB 3.0. This was a decision based on the broad demand for SQL and the continued growth and adoption of InfluxQL. We are continuing to support Flux for users in 1.x and 2.x so you can continue using it with no changes to your code. If you are interested in transitioning to InfluxDB 3.0 and want to future-proof your code, we suggest using InfluxQL.

For information about the future of Flux, see the following: