---
title: influx config set
description: The influx config set command updates an InfluxDB connection configuration.
url: https://docs.influxdata.com/influxdb3/cloud-serverless/reference/cli/influx/config/set/
estimated_tokens: 1639
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb3/cloud-serverless/reference/cli/influx/config/set/
date: '2025-04-02T15:54:32-06:00'
lastmod: '2025-04-02T15:54:32-06:00'
---

* influx CLI 2.0.0+

The `influx config set` command updates information in an InfluxDB connection
configuration in the `configs` file (by default, stored at `~/.influxdbv2/configs`).

## Usage

```
influx config set [flags]
```

#### Command aliases

`set` , `update`

## Flags

|                                                                                   Flag                                                                                    |                     |                                Description                                 |Input type|Maps to [?](/influxdb/cloud-serverless/reference/cli/influx/#view-mapped-environment-variables)|
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------|----------------------------------------------------------------------------|----------|-----------------------------------------------------------------------------------------------|
|                                                                                   `-a`                                                                                    |     `--active`      |                   Set the specified connection to active                   |          |                                                                                               |
|                                                                                   `-n`                                                                                    |   `--config-name`   |      Name for the InfluxDB connection configuration to set or update       |  string  |                                                                                               |
|                                                                                   `-h`                                                                                    |      `--help`       |                         Help for the `set` command                         |          |                                                                                               |
|                                                                                                                                                                           |  `--hide-headers`   |                    Hide table headers (default `false`)                    |          |                                     `INFLUX_HIDE_HEADERS`                                     |
|                                                                                   `-u`                                                                                    |    `--host-url`     |         URL for InfluxDB connection configuration to set or update         |  string  |                                                                                               |
|                                                                                                                                                                           |      `--json`       |                   Output data as JSON (default `false`)                    |          |                                     `INFLUX_OUTPUT_JSON`                                      |
|                                                                                   `-o`                                                                                    |       `--org`       |             Organization name for the connection configuration             |  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

##### Update a connection configuration and set it to active

```sh
influx config set --active \
  -n config-name \
  -t mySuP3rS3cr3tT0keN \
  -o example-org
```

##### Update a connection configuration and do not set it to active

```sh
influx config set \
  -n config-name \
  -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)
| Flag |  | Description | Input type | Maps to  ? |
| --- | --- | --- | --- | --- |
| Flag |  | Description | Input type | Maps to  ? |
| -a | --active | Set the specified connection to active |  |  |
| -n | --config-name | Name for the InfluxDB connection configuration to set or update | string |  |
| -h | --help | Help for the  set  command |  |  |
|  | --hide-headers | Hide table headers (default  false ) |  | INFLUX_HIDE_HEADERS |
| -u | --host-url | URL for InfluxDB connection configuration to set or update | string |  |
|  | --json | Output data as JSON (default  false ) |  | INFLUX_OUTPUT_JSON |
| -o | --org | Organization name for the connection configuration | 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 |  |  |  |