content/shared/influxdb-v2/reference/cli/influx/setup/_index.md
The influx setup command walks through the initial InfluxDB OSS setup process,
creating a default user, organization, and bucket.
{{% note %}} The Operator token created in the InfluxDB setup process has full read and write access to all organizations in the database. {{% /note %}}
influx setup [flags]
| Flag | Description | Data type | {{< cli/mapped >}} | |
|---|---|---|---|---|
-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 |
{{% note %}}
Valid --retention units are nanoseconds (ns), microseconds (us or µs),
milliseconds (ms), seconds (s), minutes (m), hours (h), days (d), and weeks (w).
{{% /note %}}
influx setup
influx setup \
--org example-org \
--bucket example-bucket \
--username example-user \
--password ExAmPl3PA55W0rD \
--force