---
title: Recover user credentials
description: Recover InfluxDB user credentials using the influx CLI.
url: https://docs.influxdata.com/influxdb/v2/admin/users/recover-credentials/
estimated_tokens: 847
product: InfluxDB OSS v2
version: v2
---

# Recover user credentials

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 `influxd` command line interface (CLI) to recover user credentials and regain access to your InfluxDB instance:

-   [Update a password](#update-a-password)
-   [List existing users in the InfluxDB instance](#list-existing-users-in-the-influxdb-instance)
-   [Create a user for recovery purposes](#create-a-user-for-recovery-purposes)

## Update a password

To update a password, run the following:

```sh
influxd recovery user update \
  --username example-username \
  --password ExAmPL3-paS5W0rD
```

**Note:** If you’re not sure of the username, [list existing users in the InfluxDB instance](#list-existing-users-in-the-influxdb-instance) or [create a user for recovery purposes](#create-a-user-for-recovery-purposes).

## List existing users in the InfluxDB instance

To list existing users in the system, run the following:

```sh
influxd recovery user list
```

If you used a [custom `bolt-path`](/influxdb/v2/reference/config-options/#bolt-path) when starting InfluxDB, provide your custom bolt path to the `influx recovery user list` command with the `--bolt-path` flag.

## Create a user for recovery purposes

To create a new user for recovery purposes, run the following:

```sh
influxd recovery user create \
  --username example-username \
  --password ExAmPL3-paS5W0rD
```

#### Related

-   [influxd recovery](/influxdb/v2/reference/cli/influxd/recovery/)