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/PlatformCLI 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

FlagDescriptionInput typeMaps to ?
-a—activeSet the specified connection to be the active configuration.
-n—config-name(Required) Name of the new configuration.string
-h—helpHelp for the create command
—hide-headersHide table headers (default false)INFLUX_HIDE_HEADERS
-u—host-url(Required) Connection URL for the new configuration.string
—jsonOutput data as JSON (default false)INFLUX_OUTPUT_JSON
-o—orgOrganization namestring
-t—tokenAPI tokenstringINFLUX_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