---
title: "Recover access to Frappe Cloud when you lose your 2FA device"
space: "Framework"
url: "https://docs.frappe.io/framework/help/recover-access-to-frappe-cloud-when-you-lose-your-2fa-device"
updated: "2026-11-20"
---

If you turned on two-factor authentication (2FA) for your Frappe Cloud account and then lost the phone or app that generates your code, you do not need to raise a ticket first. You can get back in yourself with a recovery code.

## **Before you start**

- You still need your account's email address and password. 2FA is a second step after that, not a replacement for it.
- You need one of the 9 recovery codes Frappe Cloud showed you when you first turned on 2FA. Each code is a 16-character mix of letters and numbers, for example `C6BD7F3DC3C5777D`.

## **Steps**

1. Go to the Frappe Cloud login page and sign in with your email and password as usual.
2. On the **2FA Code from your Authenticator App** screen, click **Reset 2FA** below the Verify button.
  ![](/files/pasted-image-bz2orvod.webp)
3. In the **Recovery Code** field, enter one of your saved recovery codes, then click **Reset**.
4. You see "2FA reset successfully. Please re-enable it as soon as possible!" and land back on the login page. 2FA is now off for your account.
5. Log in again with just your email and password.
6. Go to **Settings → Profile** and click **Enable** next to 2FA to turn it back on with a device you still have. Save the new set of recovery codes somewhere you will not lose with your phone, for example a password manager.

Using any one recovery code turns 2FA off entirely. It does not use up one code while leaving 2FA on, so step 6 matters: until you re-enable it, your account only needs a password to sign in.

## **If you do not have a recovery code either**

There is no self-service option left at that point: the recovery code is the only way to reset 2FA yourself from the login screen. Raise a ticket from the [support portal](https://support.frappe.io/helpdesk/my-tickets/new) and ask to have 2FA disabled on your account.

Because this turns off a security control, support verifies you own the account before doing it. Expect to be asked to confirm the billing address and last 4 digits of the card on the account, or, if someone other than the account owner raised the ticket, to have the account owner reply with consent. If a teammate who is not the account owner loses access, the account owner has to raise or approve the ticket — support will not disable another user's 2FA on the teammate's request alone.

## **How to prevent this**

- Save all 9 recovery codes when you first enable 2FA, in a password manager rather than a screenshot on the same phone as your authenticator app.
- Back up your authenticator app's vault, or use one that syncs to a second device.
- Frappe Cloud emails a monthly reminder to review your recovery codes until you turn it off (**Settings → Profile → Recovery Code Reminders**). When it arrives, go to **Settings → Profile → View Recovery Codes → Show**, verify the code sent to your email, and confirm you still have the codes saved — before you are ever locked out.

## **Related**

- [Two-factor authentication (2FA)](https://docs.frappe.io/cloud/two-factor-authentication-2fa)
- [Forgot Password](https://docs.frappe.io/cloud/common-issues/forgot-password-of-frappe-cloud)