LibrePortal
Sponsor Get started

LibreVault troubleshooting

What to do when LibreVault will not unlock, a server does not appear, a vault says it is waiting, or the LibrePortal app says LibreVault is locked.

On this page
  1. I forgot my Keyring password
  2. A server does not appear in LibreVault
  3. The LibrePortal app says LibreVault is locked
  4. It says "Waiting to save"
  5. A spare copy says it is behind or cannot be reached
  6. A website will not sign in by itself
  7. My imported logins have no folders
  8. Nothing is offered in another app
  9. My server "can't be reached" on the phone
  10. Still stuck

I forgot my Keyring password#

Use your recovery key: on the lock screen press Forgot your password? Use your recovery key, type the key, and choose a new password. If you did not make a recovery key, nobody can open the Keyring for you. Each server's own vault still opens with that vault's own password. Find a .lvault backup file if you saved one, and open it with its password.

A server does not appear in LibreVault#

  1. Check the server is in the LibrePortal app and shows as Online.
  2. Make sure LibrePortal on the server is up to date: a recent LibrePortal tells LibreVault where the vault answers.
  3. If you started LibreVault before the LibrePortal app, close and open it again. It looks for the app's servers when it starts.
  4. As a last step, press Enter an address instead on the first screen and type the server's private address and port.

The LibrePortal app says LibreVault is locked#

Some jobs, such as restarting a server that has an encrypted disk, need a password from LibreVault. The app waits instead of failing, and a notification says LibreVault is locked. Open LibreVault and unlock it. The job carries on by itself.

It says "Waiting to save"#

Your change is kept on this device and goes to the server when it can be reached. Nothing is lost. It may be that the server is restarting, or your VPN is reconnecting.

A spare copy says it is behind or cannot be reached#

The copy is refreshed every few minutes. If it stays amber, check the LibreBackup is on and answering, and that its VPN is connected. After you change a password the copy can be a few minutes behind and may still want the previous password. That is normal.

A website will not sign in by itself#

Check the login has the exact address of the site, and an authenticator key if the site asks for a code. Then try again from inside the LibrePortal app's browser.

My imported logins have no folders#

LibreVault before 0.1.2 left the folders out when it imported a Bitwarden or Vaultwarden file. Update LibreVault, then import the same file again: Settings, Backup files, Import from Bitwarden, and choose the server you imported into. Every item goes back into its folder. Nothing is added twice, and changes you made since are kept. An item you have already put in a folder yourself stays where you put it.

Nothing is offered in another app#

  • In LibreVault, check Settings > General > Fill logins in other apps says On. If it says Off, press it and choose LibreVault.
  • In Chrome, also choose Autofill using another service under Chrome's Settings > Autofill services.
  • Check the login's Website: for a website, its address (such as ovh.com); for an app, LibreVault only offers logins saved for that app (androidapp:// and the app's name).
  • A plain http:// website and sign-up or "new password" forms are left alone on purpose. See what it never fills.

My server "can't be reached" on the phone#

If the server's address starts with http:// (a server on your home network or over LibreVPN), update LibreVault to 0.1.1 or newer. Older versions on Android could not reach plain http:// addresses at all.

Still stuck#

Read Troubleshooting, or ask on the issue tracker. Never post a password, a key or a recovery key.

Next steps