Documentation

influx config create

The influx config create command creates a InfluxDB connection configuration and stores it in a local file:

OS/PlatformCLI config file path
macOS~/.influxdbv2/configs
Linux (installed as binary)~/.influxdbv2/configs
Linux (installed as service)~/var/lib/influxdb/configs
Windows%USERPROFILE%\.influxdbv2\configs
Docker (DockerHub)/etc/influxdb2/configs
Docker (Quay.io)/root/.influxdbv2/configs
Kubernetes/etc/influxdb2/configs

To view CLI connection configurations after creating them, use influx config list.

Note: If you create multiple connection configurations (for example, separate admin and user configurations), use influx config <config-name> to switch to the configuration you want to use.

Usage

influx config create [flags]
  • Copy
  • Fill window

Flags

FlagDescriptionInput typeMaps to ?
-a--activeSet the specified connection to be the active configuration.
-n--config-name(Required) Name of the new configuration.string
-h--helpHelp for the create command
--hide-headersHide table headers (default false)INFLUX_HIDE_HEADERS
-u--host-url(Required) Connection URL for the new configuration.string
--jsonOutput data as JSON (default false)INFLUX_OUTPUT_JSON
-o--orgOrganization namestring
-t--tokenAPI tokenstringINFLUX_TOKEN
-p--username-password(OSS only) Username (and optionally password) to use for authentication.
Include username:password to ensure a session is automatically authenticated. Include username (without password) to prompt for a password before creating the session.string

Examples

Create a connection configuration and set it active

influx config create --active \
  -n config-name \
  -u https://cloud2.influxdata.com \
  -t mySuP3rS3cr3tT0keN \
  -o example-org
  • Copy
  • Fill window

Create a connection configuration without setting it active

influx config create \
  -n config-name \
  -u https://cloud2.influxdata.com \
  -t mySuP3rS3cr3tT0keN \
  -o example-org
  • Copy
  • Fill window

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

New in InfluxDB 3.2

Key enhancements in InfluxDB 3.2 and the InfluxDB 3 Explorer UI is now generally available.

See the Blog Post

InfluxDB 3.2 is now available for both Core and Enterprise, bringing the general availability of InfluxDB 3 Explorer, a new UI that simplifies how you query, explore, and visualize data. On top of that, InfluxDB 3.2 includes a wide range of performance improvements, feature updates, and bug fixes including automated data retention and more.

For more information, check out:

InfluxDB Cloud Serverless