influx config create

  • influx CLI 2.0.0+
  • InfluxDB 2.0.0+
  • Updated in CLI 2.5.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.

Note: If you create multiple connection configurations (for example, separate admin and user configurations), use influx config to switch to the configuration you want to use.

Usage

1. 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

1. influx config create --active \
2. -n config-name \
3. -u http://localhost:8086 \
4. -t mySuP3rS3cr3tT0keN \
5. -o example-org

Create a connection configuration without setting it active

1. influx config create \
2. -n config-name \
3. -u http://localhost:8086 \
4. -t mySuP3rS3cr3tT0keN \
5. -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.

Use the --username-password, -p option to provide your username and password using the <username>:<password> syntax. If no password is provided, the CLI will prompt for a password after each command that requires authentication.

1. influx config create \
2. -n config-name \
3. -u http://localhost:8086 \
4. -p example-user:example-password \
5. -o example-org