The influxctl command line interface (CLI) performs administrative tasks in an InfluxDB Cloud Dedicated cluster.


influxctl [flags] [command]


databaseManage InfluxDB databases
tokenManage InfluxDB database tokens
versionOutput the current influxctl version
helpOutput influxctl help information

Global flags

--debugEnable debug logging
--profileSpecify a connection profile to use (default is default)

Download and install influxctl

Contact InfluxData Support for information about downloading and installing the influxctl CLI.

Configure connection profiles

To connect with your InfluxDB Cloud Dedicated cluster, influxctl needs the following credentials:

  • InfluxDB Cloud Dedicated account ID
  • InfluxDB Cloud Dedicated cluster ID

Use the influxctl init command to start an interactive prompt that creates and stores the required credentials as a connection profile.

influxctl init

Connection profile store location

The influxctl CLI stores connection profiles in a config.toml file at a specific location based on your operating system:

Profile configuration file locations

Operating systemProfile configuration filepath
macOS~/Library/Application Support/influxctl/config.toml


The influxctl CLI uses Auth0 to authenticate access to your InfluxDB Cloud Dedicated cluster. When you issue an influxctl command, the CLI checks for an active Auth0 token. If none exists, you are directed to login to Auth0 via a browser using credentials you should have created when setting up your InfluxDB Cloud Dedicated cluster. Auth0 issues a short-lived (1 hour) token that authenticates access to your InfluxDB Cloud Dedicated cluster.

Was this page helpful?

Thank you for your feedback!

Introducing InfluxDB 3.0

The new core of InfluxDB built with Rust and Apache Arrow. Available today in InfluxDB Cloud Dedicated.

Learn more

State of the InfluxDB Cloud Serverless documentation

The new documentation for InfluxDB Cloud Serverless is a work in progress. We are adding new information and content almost daily. Thank you for your patience!

If there is specific information you’re looking for, please submit a documentation issue.