---
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: 493
product: InfluxDB OSS v2
version: v2
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb/v2/admin/users/recover-credentials/
date: '2024-03-25T11:31:59-06:00'
lastmod: '2024-03-25T11:31:59-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 `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]
> **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
```

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