Invalid password or key file

KeePassium has two kinds of passwords:

  • App Protection passcode — it protects the app itself. The app unlock screen has only one input field (see screenshot). This passcode is defined when you enable the App Lock function. Instead of entering this passcode, you can use Face ID/Touch ID scanner.

    App protection screen
    App protection screen

  • Database encryption password (master password) — the one used for protecting the database. The database unlock screen has two input fields (password + optional key file). You defined this password when you created your database.

    Database unlock screen
    Database unlock screen

Normally, when you unlock the database for the first time, KeePassium remembers the database password for your convenience. This way, the app can unlock the database automatically after a successful face or fingerprint scan.

Why did it lock up?

Sometimes, KeePassium erases the remembered database password. For example, this happens if you remove the database from the app or if someone tries to unlock KeePassium with a wrong passcode. To protect your passwords, the app locks up the database. After this, you would need to enter the full database password to unlock the database.

What can I do?

If you don’t remember your database password, unfortunately this would be bad news… There is no way to reset or restore this password. This is by design, as a necessary requirement for strong security. (If you could restore your master password, anybody else could do this, too.) The database can be decrypted only with the correct password.

Before panicking, there are two things to check.

  1. Try to open an earlier version of the database:
    • In KeePassium, open the list of databases
    • Open list settings (bottom-left button)
      • Turn on the Show Backup Files switch
      • Set sorting to Modification Date (Recent First)
      • Tap Done to close the settings
    • In the list of databases, you will see backup files made by KeePassium
    • Find a backup database from September/early October and try to open it with the password you remember. If this works, please contacts us for the next steps.
  2. In older KeePassium versions, the native iOS password manager interfered with the app and offered to create a master password for your database. That prompt appeared directly in KeePassium and looked like part of the app. Try opening device settings → Passwords, and check if there is any stored password for “keepassium.com". If yes, try to use this password to unlock the database.

Otherwise, if you have any idea what your master password looks like, the best approach is to try and remember it.

  • Make sure to press the eye button to avoid accidental typos.
  • The key file is an expert option. If you don’t know whether you need it, leave it empty.

The alternative would be to create a new database and start from the scratch…

Last Updated: 2020-11-02