Factory Reset

With the help of Yubico Authenticator, the YubiKey can be reset to factory default settings by application.

Depending on the YubiKey model and platform, this can include the FIDO2, OATH, and PIV applications. If one application is reset, the others are not affected.

What happens during a reset?

When the FIDO2 application is reset, the FIDO2 PIN and all fingerprints, passkeys, and non-passkey FIDO2 credentials are removed from the YubiKey. Similarly, when the OATH application is reset, all OATH account credentials plus the OATH application password are removed.

When the PIV application is reset, all private keys and certificates are removed from the YubiKey, and the PIN, PUK, and management key are reset to their factory default values.

The Yubico OTP application itself can’t be reset, but the configuration of each slot can be deleted. See Slots: Yubico OTP Application for instructions on how to perform this operation.

Warning

Once an application is reset, the operation cannot be undone.

How does a reset affect my accounts?

While a reset removes credentials from the YubiKey, it does not affect the accounts and services that those credentials are registered with.

For example, suppose you registered a YubiKey for OATH authentication with your GitHub account. If you reset the OATH application on your key, the OATH credentials linked to your GitHub account will be removed from the key, but if you log into your GitHub account, you’ll still see the key registered for two-factor authentication in your settings. However, you will not be able to authenticate to your account using that key because it no longer has the corresponding OATH credentials. To use the key with that account again, you will have to reregister it.

Performing a reset on desktop and Android

To reset an application, do the following:

  1. Plug your YubiKey into your device, click the menu icon in the upper left corner of the app, and select Home.

    To connect via NFC on desktop, click the NFC icon in Yubico Authenticator and place your YubiKey on top of a desktop NFC reader. The key must maintain constant contact with the reader throughout the operation.

    To connect via NFC on Android, tap your YubiKey on the back of your device to scan.

  2. Select Factory reset under Device.

    To find the Device menu in a narrow app window, click the three dots in the upper right corner of the app.

  3. In the Factory reset window, select the application you’d like to reset and click Reset.

  4. If you selected the OATH application and are connected via NFC on Android, tap your key against the NFC reader when prompted. No other steps are required to perform the reset for OATH and PIV.

    For the FIDO2 application with USB connections, unplug your YubiKey, reinsert your key into your device, and touch your key when prompted (for YubiKey Bio Series keys, touch the fingerprint sensor; for all other keys, touch the gold contact). Once the status reads “FIDO application reset”, click Close on desktop or the X on Android to return to Home.

    _images/reset-desktop.jpg

    For the FIDO2 application with desktop NFC connections, remove your key from the NFC reader and place it back on the NFC reader when prompted. Once the status reads “FIDO application reset”, click Close.

    For the FIDO2 application with NFC connections on Android, tap your key against the NFC reader when prompted. Once the operation is complete, click the X to return to Home.

Note

Once the key has been reset, you must reregister it with your accounts to continue using it for authentication with those sites and services.

Performing a reset on iOS/iPadOS

For Yubico Authenticator for iOS/iPadOS, only the OATH application can be reset. To perform a reset for this application on your iOS/iPadOS device, do the following:

  1. Open the Yubico Authenticator app. For Lighting connections, plug in your YubiKey. For NFC connections, swipe down on the screen and tap your YubiKey on the back of your device to scan.

  2. Click the three dots in the upper right corner of the app and select Configuration.

  3. On the Configuration screen, select Passwords and reset.

  4. At the bottom of the screen, click Reset YubiKey. In the Reset YubiKey? window, click Reset again to confirm.

    For NFC connections, scan your key when prompted.

    For Lightning connections, click OK to close the window once the operation is complete.

    _images/reset-ios.jpg

Note

Once the key has been reset, you must reregister it with your accounts to continue using it for authentication with those sites and services.