influx config create
The influx config create command creates a InfluxDB connection configuration
and stores it in a local file:
| OS/Platform | CLI 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]
Flags
| Flag | Description | Input type | Maps to ? | |
|---|---|---|---|---|
-a | --active | Set the specified connection to be the active configuration. | ||
-n | --config-name | (Required) Name of the new configuration. | string | |
-h | --help | Help for the create command | ||
--hide-headers | Hide table headers (default false) | INFLUX_HIDE_HEADERS | ||
-u | --host-url | (Required) Connection URL for the new configuration. | string | |
--json | Output data as JSON (default false) | INFLUX_OUTPUT_JSON | ||
-o | --org | Organization name | string | |
-t | --token | API token | string | INFLUX_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
- Create a connection configuration without setting it active
Create a connection configuration and set it active
influx config create --active \
-n config-name \
-u http://localhost:8086 \
-t mySuP3rS3cr3tT0keN \
-o example-org
Create a connection configuration without setting it active
influx config create \
-n config-name \
-u http://localhost:8086 \
-t mySuP3rS3cr3tT0keN \
-o example-org
Was this page helpful?
Thank you for your feedback!
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for InfluxDB and this documentation. To find support, use the following resources:
InfluxDB Cloud and InfluxDB Enterprise customers can contact InfluxData Support.