Basic YubiKey Troubleshooting

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.

If these steps don't resolve your issue, consider opening a support ticket here.

Note: YubiKeys use capacitive touch sensors, so if your skin is dry, it will be harder for a touch to be detected. Lotion may help this, and you can also try applying more pressure to make sure your finger covers more of the sensor.