If you're having trouble setting up or using your passkey, this guide will help you resolve common issues.
Before you start, here are steps that commonly help:
- Android: Open in Chrome
- iOS: Open in Safari
- Enable screen lock on your device (PIN, fingerprint, or Face ID)
- Update your device and browser to the latest version
- Restart phone - sometimes this helps as well
Common Error Messages
"Passkey setup was blocked" (NotAllowedError)
This error occurs when your browser or device blocks passkey creation. This is the most common issue and can happen for several reasons.
Android Devices
Try these solutions in order:
- Exit Incognito/Private mode - Use regular Chrome instead
- Sign into Google account - Make sure you're signed into a Google account in Chrome
- Enable phone screen lock - Go to Settings > Security and set up a PIN, pattern, or biometric lockso
- Turn off VPN temporarily - Some VPN or privacy apps can interfere with passkeys
- Update your apps - Update Google Play Services and Chrome to the latest versions
⚠️ Important Note for Budget Android Devices:
Lower-end Android devices (like some Redmi, Realme, or other budget brands) may require recent security updates for passkeys to work properly. If your device hasn't received security patches in over 6 months, passkey support may be limited even with screen lock enabled.
iOS Devices (iPhone/iPad)
Try these solutions:
- Exit Private Browsing - Use regular Safari instead of Private Browsing mode
- Enable Face ID/Touch ID - Go to Settings and make sure Face ID or Touch ID is enabled
- Enable iCloud Keychain - Go to Settings > [Your Name] > iCloud > Passwords and Keychain, and turn on iCloud Keychain
- Turn off VPN temporarily - Disable any VPN apps while setting up your passkey
Desktop/Web Browsers
Try these solutions:
- Exit Incognito/Private mode - Use a regular browser window
- Open In Chrome - if you use a different browser, try Chrome (or Safari on Mac)
- Check security settings - Ensure your browser allows passkeys/security keys
- Restart your browser - Close and reopen your browser completely
- Update your browser and OS - Make sure you have the latest updates installed
"Credential manager is busy" (NotReadableError)
This error means your device's credential manager is temporarily unavailable.
Android Devices
- Restart your device - A simple restart usually fixes this
- Update Google Play Services - Make sure Google Play Services is up to date
- Enable screen lock - Go to Settings > Security and enable screen lock if it's not already on
Other Devices
- Wait a moment - The credential manager may be processing another request
- Restart your device - This refreshes the credential manager
- Try again - The issue is usually temporary
"A passkey already exists for this device" (InvalidStateError)
You've already created a passkey for this account on this device. You can:
- Use your existing passkey to sign in
- Or delete the existing passkey from your device's password manager and create a new one
"Passkeys are not supported on this device" (NotSupportedError)
Your device or browser doesn't support passkeys. To use passkeys, you need:
- iOS/iPadOS: Version 16 or later
- Android: Version 9 or later with updated Google Play Services
- Desktop: Recent version of Chrome, Safari, Edge, or Firefox
- Screen lock: PIN, pattern, password, or biometric authentication must be enabled
General Troubleshooting Tips
If none of the above solutions work, try these additional steps:
- Clear browser cache - Clear your browser's cache and cookies, then try again
- Try a different browser - Test with Chrome, Safari, or Edge to see if the issue is browser-specific
- Check browser extensions - Disable password managers or security extensions temporarily
- Update your device - Make sure your operating system has the latest updates
- Check date and time - Ensure your device's date and time are set correctly
Still Having Issues?
If you've tried all the steps above and are still experiencing problems, please contact our support team:
- Visit: peanut.me/support
- Include the specific error message you're seeing
- Let us know your device type (iPhone, Android, etc.) and browser
We're here to help!