MiniKeePass migration guide

MiniKeePass is no longer maintained. Actually, it has not been maintained since 2017, but now its developers made it official:

MiniKeePass deprecation screenshot
MiniKeePass: This app is no longer maintained. Please export your data using the instructions in the help menu (?) on the "Files" screen. This app will not be avaible after 2020.

This guide will help you migrate from MiniKeePass to KeePassium.

Why KeePassium?

How to transfer your data

Local files: Copy to KeePassium

  • Install KeePassium
  • Unlock your database in MiniKeePass
  • Press the Share button (square with an arrow)
  • On iOS 13, scroll the icons to the left → More...Copy to KeePassium. On iOS 12, simply scroll down to Copy to KeePassium and press it.
  • Your database will open in KeePassium.
Export database from MiniKeePass to KeePassium
How to export your database from MiniKeePass

Cloud files: Open in place

KeePassium can open databases directly from the cloud. This way, the app will automatically download the latest database from the cloud, and upload any modifications back. MiniKeePass could not do that, so some people never even look for this feature :)

All the synchronization is delegated to the specialized app of your cloud provider. Due to this separation of concerns, KeePassium can be an offline app with cloud synchronization. KeePassium never even asks for your server credentials, it has access only to the few specific files that you add to the app.

Here’s the general procedure:

  1. Install the storage provider app and login into your account
  2. Open KeePassium,
  3. Press Add Existing Database (or top-right + button)
  4. Press Browse to see the available storage locations
  5. If your cloud provider is not in the list, make it visible
  6. Navigate to your database and select it

Note: Some of storage apps work better than others, so make sure to check the list of supported storage providers, sync troubleshooting guide, or contact us.

Lost files: Extract from iTunes backup

If you migrate to a new iPhone/iPad, you will discover that MiniKeePass cannot be installed and your most recent database is no longer available.

Don’t worry, you can still extract your database from an iTunes backup.

  • Install and run iBackup Extractor (free version)
  • In the top-left dropdown selector, choose a previous backup of your phone.
  • If the backup was encrypted, enter the iTunes backup password (it’s independent from your KeePass database password or Apple ID password).
  • In the leftmost column, select the last item “Files”
  • In the next column, select “Documents” and find your .kdb/.kdbx file in the list.
  • Press “Copy Selection…” and save the database to your computer.

KeePassium settings

KeePassium protection is designed similar to MiniKeePass.

The app itself is protected by an App Lock passcode (“PIN protection” in MiniKeePass). Instead of entering the passcode, you can enable Face ID / Touch ID.

App protection settings: KeePassium vs MiniKeePass
App protection settings: KeePassium vs MiniKeePass

Your database is protected by its own master key (password, key file, YubiKey). For your convenience, KeePassium can remember database master key in device’s keychain. This way, the app will automatically unlock the database, even if KeePassium was killed by the system.

Data protection settings: KeePassium vs MiniKeePass
Data protection settings: KeePassium vs MiniKeePass

Troubleshooting

KeePassium appears in a wrong language

This happens when the app is not translated to the default language of your device.

  • Open device settings → General → Language & Region
  • Press Edit and reorder the languages by your preference (If your language is not in the list, you can add it by pressing Add Language...)
  • The app will appear in the first available language in this list
Screenshot: Preferred languages
Preferred interface languages

Also, you can help translate KeePassium to your language; this does not require any special technical knowledge.

Error: Cannot parse database. Nil value in Entry/Times or Group/Times.

This happens sometimes with old MiniKeePass databases that were edited by different versions of different apps — some of these versions had minor data corruption bugs. Usually, the error shows that some groups and entries in your database are missing mandatory fields (timestamps).

KeePassium, in turn, very carefully checks that the incoming data is correctly formatted. So when the app finds that a mandatory field is missing, it stops loading the database. This way, KeePassium ensures that it won’t accidentally ignore an important problem and protects your data from further corruption.

To solve this, open your database in KeePass or KeePassXC, then save the file. The desktop app will fill in any missing fields, and KeePassium will be able to open it.