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 %}}

## Usage
```
influx setup [flags]
```

## 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 %}}

## Examples

##### Set up InfluxDB interactively with prompts for required information

```sh
influx setup
```

##### Set up InfluxDB with all required information and skip confirmation

```sh
influx setup \
  --org example-org \
  --bucket example-bucket \
  --username example-user \
  --password ExAmPl3PA55W0rD \
  --force  
```