Recover your Docker account and two-factor recovery code
Get back into your Docker account when you lose your authenticator app, your recovery code, or both. Docker asks for your password before it shows or replaces the recovery code.
ImportantThe recovery code works once. Using it on the Lost Authentication Device page signs you in, turns 2FA off, and deletes the code. Turn 2FA on again from your new device as soon as you're signed in.
Generate a new recovery code
If you lost your recovery code and can still sign in, generate a new one. The new code replaces the previous code.
- Sign in to your Docker account. Enter your password, then the code from your authenticator app.
- Select your avatar in the top-right corner, then select Account settings.
- Select 2FA.
- Enter your password, then select Confirm.
- Select Generate new code.
Select the visibility icon to view the new code. Then select Copy, Download, or Print, and store the code somewhere safe.
Sign in with your recovery code
If you lost your authenticator app and still have your recovery code, use the code to sign in.
- Sign in to your Docker account with your username and password.
- On the Two-Factor Authentication page, select I've lost my authentication device.
- Enter your recovery code, then select Verify.
You're signed in and 2FA is off. To protect your account again, follow Turn on 2FA.
Contact Docker Support
If you lost both your authenticator app and your recovery code, open the Contact Support form. The subject and description already describe a 2FA lockout. Enter the email address on your Docker account, then follow the instructions from Docker Support.
Next steps
- Turn on 2FA again after you recover your account.
- Create a personal access token for the Docker CLI and automation.