> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/guides-and-quickstarts/personal-settings-and-support/password-recovery-and-mfa.md).

# Password recovery and MFA

Use password recovery when you cannot sign in to a password-based account. Multi-factor authentication (MFA) adds a verification code to the sign-in process.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2FWVo3hmRTzG1hSEH9JPLd%2FG105.mp4?alt=media&token=ce3c681a-c439-4405-a29b-4786f94358c3>" %}

## Before you start

First identify where you sign in: StackAI password, Google, or organizational SSO. Use the recovery flow for that sign-in provider. If your authenticator is unavailable, go directly to the lost-authenticator section below instead of repeatedly requesting a password reset.

To set up MFA, have an authenticator application available. Keep access to the email address used by your account for password recovery.

## Reset a forgotten password

On the sign-in page, select **Forgot password?**

![Forgot password sign-in control](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/NhZJnrbohJaUCmgsshNU/assets/g105-g105-01-login.png)

Enter your account email address and request a recovery email.

![Password recovery email entry](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/6GKErng2jyGEaGYV2cqR/assets/g105-g105-02-request.png)

Open the reset link in that email. Enter and confirm your new password, then select **Update Password**.

![New-password reset form](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/KlGajHqkqEJPnjLEUCw4/assets/g105-g105-03-reset.png)

Return to the sign-in page and use the new password.

![Sign-in with the updated password](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/c1NqYARVb4zgKsa4ATe0/assets/g105-g105-04-signin.png)

## Change a password while signed in

Open **Settings → Profile → Change password**, if this option is available. Complete the password fields and save the change.

![Profile Change password control](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/FBPam3d6trTKi6Phpsvw/assets/g105-g105-05-change.png)

## Set up an authenticator

At the enrollment prompt, select **Set up MFA**.

![Set up MFA enrollment prompt](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/o34J2VHW0OF4EylWgkuV/assets/g105-g105-06-begin.png)

In your authenticator application, add an account. Scan the displayed QR code or enter the manual setup secret.

![Authenticator QR code and manual setup option](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/QTQwPLc1CPAyIaXJWCJF/assets/g105-g105-07-enroll.png)

Enter the current code from your authenticator and select **Verify Code**. This completes enrollment.

![Verify Code enrollment step](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/r2a0hx8FhaL0neiezjeI/assets/g105-g105-08-verify.png)

## Sign in with MFA

When StackAI asks for a verification code, open the matching account in your authenticator. Enter the current code.

![Authenticator challenge during sign-in](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/ywruFzIPCvTAVH9rR4Ws/assets/g105-g105-09-challenge.png)

After successful verification, StackAI opens your account.

![Account after MFA verification](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/XJFf9nsLzhRmseU59ZsQ/assets/g105-g105-10-result.png)

## If you no longer have the authenticator

If the challenge is shown by your organization's identity provider, use that provider's recovery process or contact your IT help desk. StackAI password recovery does not manage the provider's MFA.

If StackAI asks for the code and you no longer have its authenticator account, contact your organization administrator and established StackAI support contact. There is no self-service option in this sign-in flow to remove a lost authenticator. Do not assume that resetting the password removes an enrolled factor.

Provide your account email, organization, deployment URL, the sign-in method, and the exact error or challenge you see. Never send a current code, QR code, setup secret, password, or session token. If you cannot reach Settings because you are locked out, ask an administrator who can sign in to use [Support and deployment diagnostics](https://docs.stackai.com/guides-and-quickstarts/personal-settings-and-support/support-and-deployment-diagnostics.md) on your behalf. Support can advise on the recovery process.

After recovery is completed, enroll the replacement authenticator if required and verify a fresh sign-in before closing the working session.

## Important behavior

For Google or SSO sign-in, use your identity provider’s password recovery process.

If a verification code is rejected, check that you selected the correct account in the authenticator. Check your device time and use a new code if the previous one expired.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stackai.com/guides-and-quickstarts/personal-settings-and-support/password-recovery-and-mfa.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
