# Passkey Recovery

The Passkey Recovery module restores dead sessions using a previously saved FIDO2 passkey. If an account's session has expired or been revoked, but a passkey was registered on it (via the Registration or Checker module), this module can create a brand new working session.

![Passkey Recovery settings](/files/31F3DF30svncZUTQvkmc)

## How Passkeys Work

A FIDO2 passkey is a cryptographic credential stored in the database alongside each account. It acts as a backup login method:

1. **Registration/Checker** creates the passkey when the account is alive
2. If the session later dies (AUTH\_KEY\_DEAD, SESSION\_REVOKED), the passkey remains valid
3. **Passkey Recovery** uses the passkey to log in and create a new working session

{% hint style="info" %}
Passkeys are only useful if they were registered **before** the session died. You cannot create a passkey for an already dead session.
{% endhint %}

## Settings Reference

| Setting     | Description                                                |
| ----------- | ---------------------------------------------------------- |
| **Threads** | How many accounts to recover at the same time. Default: 3. |

## How to Use

1. Go to **Passkey Recovery** in the sidebar
2. Set the number of **Threads**
3. Select a **Proxy list**
4. In the **Accounts** section, select accounts to recover (the module automatically filters to only those with a passkey)
5. Click **Start**

{% hint style="info" %}
To prepare for future recovery, enable **Set Passkey** in the [Checker](/mvs-docs/modules/checker.md) module or enable **Passkey** in the [Registration](/mvs-docs/modules/registrator.md) module. This registers passkeys on your alive accounts so you can recover them later if needed.
{% endhint %}

## Understanding the Results

| Result                   | What It Means                                                                          |
| ------------------------ | -------------------------------------------------------------------------------------- |
| **RECOVERED (ID: XXXX)** | Session restored successfully. A new working session was created.                      |
| **TIMEOUT**              | Recovery took too long. Try again with better proxies.                                 |
| **FAILED: ...**          | Recovery failed. The passkey may be invalid, or the account may be permanently banned. |

Successfully recovered accounts get a new session and are available for use immediately. The old dead session remains in the database as historical data.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://mvs-3.gitbook.io/mvs-docs/modules/passkey-recovery.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.