Recovery Codes

If you enable any two-step login methods, it's important to understand that losing access to your secondary device(s) (for example, a mobile device with an installed authenticator, a security key, or a linked email inbox) has the potential to lock you out of your Bitwarden vault.

To protect against this, Bitwarden generates a recovery code that can be used with your master password to disable any enabled two-step login methods from outside your vault.

To get your recovery code:

1. Log in to your web vault.

2. Select the profile icon and choose Account Settings from the dropdown:

   

3. Select the Security page and the Two-step login tab:

   

4. Select the View Recovery Code button near the top of the screen. You will be prompted to enter your master password, which will open a recovery code panel:

   

Save your recovery code in the way that makes the most sense for you. Believe it or not, printing your code and keeping it somewhere safe is one of the best ways to ensure that the code isn't vulnerable to theft or inadvertent deletion.

To use your recovery code, navigate to https://vault.bitwarden.com/#/recover-2fa/ (or, if you are self-hosting, https://your.domain.com/#/recover-2fa/).

Using your recovery code is like the normal login procedure, requiring your email address and master password, but will also take your recovery code. On successful authentication of all three, you will be logged in to your vault and all two-step login methods will be disabled.

Once used, get a new recovery code, as it will change with each use. You should also at this point re-enable any two-step login methods you want to use in the future.

備考

Recovery codes will not disable Duo for organizations. You can tell that a Duo prompt is organization-wide by the (Organization) header, as in the following screenshot:

If you are locked out of your vault by a Duo (Organization) prompt, reach out to the Duo administrator at your company for help bypassing the prompt.