--- title: influx config create description: The influx config create command creates a InfluxDB connection configuration. url: https://docs.influxdata.com/influxdb/v2/reference/cli/influx/config/create/ estimated_tokens: 2318 product: InfluxDB OSS v2 version: v2 publisher: InfluxData canonical: https://docs.influxdata.com/influxdb/v2/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+ * InfluxDB 2.0.0+ * Updated in CLI 2.5.0 This page documents an earlier version of InfluxDB OSS.[InfluxDB 3 Core](/influxdb3/core/) is the latest stable version. > [!Important] > #### API token hashing is enabled by default in InfluxDB OSS 2.9.0 > > Stronger token security: tokens are stored as hashes on disk, so a > copy of the database file doesn’t expose usable tokens. Existing > tokens are hashed on first startup and the original strings can’t > be recovered afterward — **capture any plaintext tokens you still > need before you upgrade**. > > For more information, see [Token hashing](/influxdb/v2/admin/tokens/#token-hashing). 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/v2/reference/cli/influx/config/list/). > [!Note] > **Note:** If you create multiple connection configurations (for example, separate admin and user configurations), use [`influx config `](/influxdb/v2/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/v2/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 that uses a username and password](#create-a-connection-configuration-that-uses-a-username-and-password) #### 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 ``` #### Create a connection configuration that uses a username and password The **`influx` CLI 2.4.0+** lets you create connection configurations that authenticate with **InfluxDB OSS 2.4+** using the username and password combination that you would use to log into the InfluxDB user interface (UI). The CLI retrieves a session cookie and stores it, unencrypted, in your[configs path](/influxdb/v2/reference/internals/file-system-layout/#configs-path). Use the `--username-password`, `-p` option to provide your username and password using the `:` syntax. If no password is provided, the CLI will prompt for a password after each command that requires authentication. ```sh influx config create \ -n config-name \ -u http://localhost:8086 \ -p example-user:example-password \ -o example-org ``` #### Related * [influx CLI—Provide required authentication credentials](/influxdb/v2/reference/cli/influx/#provide-required-authentication-credentials) * [influx CLI—Flag patterns and conventions](/influxdb/v2/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 | |