Basic YubiKey Troubleshooting

Applicable Products


To help identify several common issues with YubiKeys, you can follow the instructions below. 

  1. Plug the YubiKey in and confirm the LED turns on. If not, try flipping it over as some USB ports are "upside down". 
  2. Check to see how your YubiKey is being identified.
    • Windows users check Devices and Printers in the Control Panel.
    • MacOS users check Apple Menu > About This Mac > System Report, and look under Hardware > USB.
    • Linux users check dmesg in Terminal.
  3. Make sure the YubiKey shows up as "YubiKey OTP+FIDO+CCID" or similar, depending on the model of YubiKey. 
  4. If you are missing one of the USB Interfaces (OTP, U2F/FIDO, or CCID) you can use the Enabling or Disabling USB Interfaces article to enable it.
  5. Test U2F by following the Testing U2F guide.
  6. Test OTP by following the Testing Yubico OTP guide.


Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.