influx setup
This page documents an earlier version of InfluxDB OSS. InfluxDB 3 Core is the latest stable version.
API token hashing is enabled by default in InfluxDB OSS 2.9.0
Stronger token security: tokens are stored as hashes on disk, so a copy of the database file doesn’t expose usable tokens. Existing tokens are hashed on first startup and the original strings can’t be recovered afterward — capture any plaintext tokens you still need before you upgrade.
For more information, see Token hashing.
The influx setup command walks through the initial InfluxDB OSS setup process,
creating a default user, organization, and bucket.
The Operator token created in the InfluxDB setup process has full read and write access to all organizations in the database.
Usage
influx setup [flags]Flags
| Flag | Description | Data type | Maps to ? | |
|---|---|---|---|---|
-c | --active-config | CLI configuration to use for command | string | |
-b | --bucket | Primary bucket name | string | |
--configs-path | Path to influx CLI configurations (default ~/.influxdbv2/configs) | string | INFLUX_CONFIGS_PATH | |
-f | --force | Skip confirmation prompt | ||
-h | --help | Help for the setup command | ||
--host | HTTP address of InfluxDB (default http://localhost:8086) | string | INFLUX_HOST | |
--http-debug | Inspect communication with InfluxDB servers. | string | ||
-o | --org | Primary organization name | string | |
-p | --password | Password for primary user | string | |
-r | --retention | Duration bucket will retain data (0 is infinite, default is 0) | duration | |
--skip-verify | Skip TLS certificate verification | INFLUX_SKIP_VERIFY | ||
-t | --token | Token for admin user (auto-generated by default) | string | INFLUX_TOKEN |
-u | --username | Primary username | string |
Valid --retention units are nanoseconds (ns), microseconds (us or µs),
milliseconds (ms), seconds (s), minutes (m), hours (h), days (d), and weeks (w).
Examples
Set up InfluxDB interactively with prompts for required information
influx setupSet up InfluxDB with all required information and skip confirmation
influx setup \
--org example-org \
--bucket example-bucket \
--username example-user \
--password ExAmPl3PA55W0rD \
--force Was this page helpful?
Thank you for your feedback!
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for InfluxDB OSS v2 and this documentation. To find support, use the following resources:
Customers with an annual or support contract can contact InfluxData Support.