Basic YubiKey Troubleshooting

This article applies to:


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 either dmesg in terminal.
  3. Make sure the YubiKey shows up as YubiKey 4 (or NEO) OTP+U2F+CCID.
  4. If you are missing one of the modes (OTP+U2F+CCID) you can use the YubiKey NEO Manager to turn it back on.
    1. Launch the YubiKey NEO Manager.
    2. Click Change connection mode.
    3. Check all boxes.
    4. Click OK.
    5. Remove and reinsert the YubiKey.
  5. Test U2F at https://demo.yubico.com/u2f in either Chrome, Firefox, or Opera.
  6. Test OTP at https://demo.yubico.com.


Helpful Articles:

Testing Yubico OTP

Testing U2F

Did you find it helpful? Yes No

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