Passbolt is a popular open-source password manager designed for teams and businesses. It's known for its security, GPG encryption, and self-hosting capabilities. However, like any software, users may occasionally encounter login issues.
If you’re facing problems logging into Passbolt, this guide will help you troubleshoot and resolve them step by step.
Before diving into complex solutions, make sure the following basic factors are not causing the problem:
✅ You’re using the correct email and passphrase.
✅ Your browser extension (Passbolt) is installed and enabled.
✅ Your internet connection is stable.
✅ The server hosting Passbolt is up and running.
Passbolt login requires the browser extension to work properly. If you're having trouble:
Fix:
Make sure the Passbolt browser extension is installed (Chrome, Firefox, etc.).
Update your browser and the extension to the latest version.
Try disabling and re-enabling the extension.
Clear browser cache or try using a private/incognito window.
Since Passbolt uses GPG keys to authenticate users, any issue with your key can prevent login.
Fix:
Ensure your private GPG key is imported into the browser extension.
If you see errors like “GPG key not found” or “Key not available”, re-import your key via the extension settings.
Try resetting your key if you’ve lost access (requires admin support or a new account setup).
Sometimes the issue is not on your end, but with the Passbolt server itself.
Fix:
Check with your IT team or system administrator if the Passbolt server is down, under maintenance, or facing SSL certificate issue
If you have 2FA enabled and cannot complete login:
Fix:
Make sure your authenticator app is synced correctly with your device's time.
Try entering backup codes if available.
If you lost access to your 2FA device, contact an admin to reset your account.
If your passphrase is incorrect or forgotten, you won’t be able to decrypt your keys.
Fix:
Passbolt doesn’t store your passphrase. If forgotten, you’ll need to reset your account with the help of an admin.
Make sure your keyboard layout hasn’t changed or is affecting input.
Sometimes, browser-specific settings or bugs can block login.
Fix:
Try logging in from a different browser or device to see if the problem persists.
This helps rule out local browser or OS-specific issues.
If all else fails, a clean reinstall of the extension can help.
Steps:
Remove the existing Passbolt browser extension.
Reinstall it from the official browser store.
Import your private key and try logging in again.
If none of the above steps solve the problem, reach out to your organization’s IT admin or contact Passbolt support directly. Provide:
A description of the issue
Screenshots (if possible)
Any error messages you received
Login issues with Passbolt are usually tied to the browser extension, GPG key configuration, or server status. By following the steps above, most users can quickly identify and fix the issue. For persistent problems, don't hesitate to involve your system administrator or support team.