---
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: 639
product: InfluxDB OSS v2
version: v2
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb/v2/admin/users/create-user/
date: '2026-05-15T15:46:14-06:00'
lastmod: '2026-05-15T15:46:14-06:00'
---

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.

> [!Note]
> 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