OTP Recovery Guide (Lost OTP Device)

If you lose access to your OTP device, follow these steps to recover your account and configure a new OTP method.

On the Keycloak login page, click Forgot password / OTP.
Enter your username. You should receive a recovery email in your inbox.
Open the email and follow the recovery link.
Scan the new QR code with your authenticator app.
Enter the generated OTP code and a device name.
- The device name is mandatory.
Change your password when prompted.
- This is required for security reasons.
Log in again as usual.
- On the OTP selection page, you will see two devices.
- Select the device with the name you just entered.
- The old one will usually appear as unnamed (if no name was set previously).

Recommended Cleanup

After logging in, go to:

Then delete the previous OTP device. If it had no custom name, it may appear as otp.