--- title: influx config create description: The influx config create command creates a new InfluxDB connection configuration. url: https://docs.influxdata.com/influxdb/cloud/reference/cli/influx/config/create/ estimated_tokens: 1993 product: InfluxDB Cloud (TSM) version: cloud publisher: InfluxData canonical: https://docs.influxdata.com/influxdb/cloud/reference/cli/influx/config/create/ date: '2025-04-02T15:54:32-06:00' lastmod: '2025-04-02T15:54:32-06:00' --- * influx CLI 2.0.0+ 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](/influxdb/cloud/reference/cli/influx/config/list/). > [!Note] > **Note:** If you create multiple connection configurations (for example, separate admin and user configurations), use [`influx config `](/influxdb/cloud/reference/cli/influx/config/) to switch to the configuration you want to use. ## Usage ``` influx config create [flags] ``` ## Flags | Flag | | Description |Input type|Maps to [?](/influxdb/cloud/reference/cli/influx/#view-mapped-environment-variables)| |---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------|----------------------------------------------------------------------------|----------|------------------------------------------------------------------------------------| | `-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-and-set-it-active) * [Create a connection configuration without setting it active](#create-a-connection-configuration-without-setting-it-active) #### Create a connection configuration and set it active ```sh influx config create --active \ -n config-name \ -u http://localhost:8086 \ -t mySuP3rS3cr3tT0keN \ -o example-org ``` #### Create a connection configuration without setting it active ```sh influx config create \ -n config-name \ -u http://localhost:8086 \ -t mySuP3rS3cr3tT0keN \ -o example-org ``` #### Related * [influx CLI—Provide required authentication credentials](/influxdb/cloud/reference/cli/influx/#provide-required-authentication-credentials) * [influx CLI—Flag patterns and conventions](/influxdb/cloud/reference/cli/influx/#flag-patterns-and-conventions) | OS/Platform | CLI config file path | | --- | --- | | 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 | | Flag | | Description | Input type | Maps to ? | | --- | --- | --- | --- | --- | | 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 | | | |