---
title: Create a user
description: Create a user in InfluxDB using the InfluxDB UI or the influx CLI.
url: https://docs.influxdata.com/influxdb/v2/admin/users/create-user/
estimated_tokens: 1181
product: InfluxDB OSS v2
version: v2
---

# Create a user

This page documents an earlier version of InfluxDB OSS. [InfluxDB 3 Core](/influxdb3/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](/influxdb/v2/admin/tokens/#token-hashing).

Use the `influx` command line interface (CLI) to create a user.

Additional users cannot be created in the InfluxDB UI.

To create a new user, you must have an [operator token](/influxdb/v2/reference/glossary/#token). For more information, see how to [create an operator token](/influxdb/v2/admin/tokens/create-token/#create-an-operator-token). Use the [`influx user create` command](/influxdb/v2/reference/cli/influx/user/create) and provide the following:

-   An [operator token](/influxdb/v2/admin/tokens/#operator-token) using your [`influx` CLI connection configuration](/influxdb/v2/reference/cli/influx/#provide-required-authentication-credentials), `INFLUX_TOKEN` environment variable, or the `--token, -t` flag.
-   The [organization name or ID](/influxdb/v2/admin/organizations/view-orgs/) to add the new user to.
-   A username for the new user with the `--name, -n` flag.
-   *Optional*: the `--password, -p` flag and a password for the user. If you don’t provide a password, the new user will be prompted to provide one.

#### Authentication credentials

The examples below assume your InfluxDB **host**, **organization**, and **token** are provided by either the [active `influx` CLI configuration](/influxdb/v2/reference/cli/influx/#provide-required-authentication-credentials) or by environment variables (`INFLUX_HOST`, `INFLUX_ORG`, and `INFLUX_TOKEN`). If you do not have a CLI configuration set up or the environment variables set, include these required credentials for each command with the following flags:

-   `--host`: [InfluxDB host](/influxdb/v2/reference/urls/)
-   `-o, --org` or `--org-id`: InfluxDB organization name or ID
-   `-t, --token`: InfluxDB API token

```sh
influx user create \
  --org ORG_NAME \
  --name USER_NAME \
  --password USER_PASSWORD
```

Replace the following:

-   `ORG_NAME`: The name of the organization to add the new user to
-   `USER_NAME`: The username of the new user
-   `USER_PASSWORD`: The password for the new user