---
title: influx config create
description: The influx config create command creates a new InfluxDB connection configuration.
url: https://docs.influxdata.com/influxdb3/cloud-serverless/reference/cli/influx/config/create/
estimated_tokens: 1976
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb3/cloud-serverless/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](/influxdb3/cloud-serverless/reference/cli/influx/config/list/).

> [!Note]
> **Note:** If you create multiple connection configurations (for example, separate admin and user configurations), use [`influx config <config-name>`](/influxdb3/cloud-serverless/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-serverless/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.  <br/>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](/influxdb3/cloud-serverless/reference/cli/influx/#provide-required-authentication-credentials)
* [influx CLI—Provide required authentication credentials](/influxdb3/cloud-serverless/reference/cli/influx/#provide-required-authentication-credentials)
| 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 |  |