---
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: 1780
product: InfluxDB Cloud Serverless
version: cloud-serverless
---

# influx config create

-   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:** 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 ? |
| --- | --- | --- | --- | --- |
| -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](/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)