KeePassium Blog

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.

KeePass + iOS + YubiKey = KeePassium

Good news, everyone!

KeePassium is the first KeePass app for iOS that supports YubiKey.

YubiKey 5 NFC
YubiKey hardware security key

KeePassium adopts the challenge-response approach used by KeePassXC. Firstly, because their approach requires only the database itself — whereas KeeChallenge and OtpKeyProv rely on auxiliary files (which would complicate synchronization). Secondly, because KeePassXC is available on all major platforms as a native app.

For more details: How to use YubiKey with KeePassium/KeePassXC.

Demo of YubiKey support in KeePassium for iOS
YubiKey support in KeePassium

Requirements

YubiKey 5 NFC

  • An NFC-capable device (iPhone 7 or later)
  • iOS 13+

YubiKey 5Ci (upcoming)

  • Any iOS device with a Lightning port
  • iOS 11+

(The App Store release version of KeePassium does not yet support YubiKey 5Ci — this requires a special permission by Yubico and Apple. The registration process is expected to take a few weeks. In the meanwhile, YubiKey 5Ci support is fully available in the beta version.)

Limitations

Unfortunately, the AutoFill part is not allowed to communicate with hardware. This limitation is set by the system. As a result, YubiKey-protected databases can only be unlocked in the main app. We are exploring a possible workaround for this nuisance.

KeePassium 1.09 — organize your passwords

Now you can organize your passwords on the go. Move entries to other groups. Copy or duplicate them. Go meta and move whole groups!

This is just a highlight, there are many more improvements:

Added

  • Move/copy groups and entries to other groups
  • Long-press menu for files, groups and entries
  • Highlight digits and special symbols in stored passwords [thanks, Sean]
  • Support for Steam TOTP with GAuth URI format [thanks, Nu11u5]
  • Support for TOTP based on SHA-256 and SHA-512 [thanks, Walter]
  • “Add Key File” button to key file pickers [thanks, Ron]

Changed

  • Use local URLs for local files, instead of resolving bookmarks
  • Preserve the entered master password after DB unlock errors [thanks, Bertrand]

Fixed

  • Occassional freezing at “Loading… 0%” (fixes #88) [thanks, everyone]
  • An attempt to fix random freezing when accessing local files on iOS 13
  • AutoFill FaceID loop on 13.1.3 [thanks, Quinn]
  • Add missing special symbols in password generator [thanks, Justen]
  • “Failed to open file” error after creating a new database [thanks, Craig]
  • Loading MiniKeePass DBs with minor issues (missing custom icon UUIDs and group timestamps) [thanks, everyone]
  • Overly wide popovers on iPadOS 13

How to use KeePass on iOS (iPadOS)

KeePassium is a part of the whole ecosystem of apps compatible with the KeePass password manager.

The key idea is that your passwords are stored in an encrypted file (database). This file can only be decrypted with the correct master password. This way, only people who know the master password can access the stored passwords.

The master password is not stored anywhere. There are no backdoors or cheat codes, so if the master password is lost or forgotten, there is no way to restore it. You may want to write your master password on a piece of paper and keep it in a safe just in case.

In general, you can think of KeePassium as a specialized viewer/editor for password databases. Pretty much like Microsoft Word can view and edit .doc files, KeePassium can view and edit .kdbx files (“kdbx” stands for “KeePass database extended”). The app itself does not contain your passwords, everything is in the database.

Database sync

You can store your password database either locally on your phone, or in a cloud storage:

  • Local (offline) mode offers somewhat higher security, since your database is never exposed to the Internet. However, you will need to regularly backup your phone: in case the phone is lost, you will still have all your passwords in the backup. Moreover, if you want to access your passwords from other devices (such as your laptop or PC), you will have to copy the database from the phone to the other devices manually. This might become annoying quite quickly.
  • Cloud-stored database makes it much easier to synchronize your passwords across different devices. You just need to save your database in a cloud-synchronized folder (such as Dropbox, iCloud Drive, or similar). Some people are concerned about saving their database in a cloud, however they tend to forget that the file is very well encrypted (if your master password is reasonably complex).

Create your first database

Ok, now that we’re done with the theory, let’s get to the practice.

  1. If you want to use cloud storage, install and setup your cloud provider’s app. In this tutorial we will use Dropbox, but it can be any of the supported sync sources.
  2. Launch KeePassium and press Create New Database
  3. Make up a master password for your database. (Ignore the No Key File field.)
  4. Press Save Database.
  5. Now, select where to store the file: either locally (On My iPhone / KeePassium), or in the cloud storage. (If Dropbox does not show among the available locations, turn it on.)
  6. Press Save
  7. In the next screen, unlock the newly created database using your master password.

Congratulations, you are in your password database!

Create new entries

You can organize your entries in folders (groups). The new database already includes a few groups for your convenience.

To create new groups and entries, press the “+” button in the top-right corner. To remove them later, just swipe them to the left.

Protect your passwords

To protect your passwords from unauthorized access, make sure to secure the app with Face ID / Touch ID. Open the settings — App Protection, and turn on the App Lock switch. The app will ask you to setup a PIN (passcode). This way, you will be able to access your passwords when the fingerprint/face scanner fails to recognize you for some reason.

Setup Password AutoFill

Now that you have a few passwords in your database, let’s see how to use them. One option is to switch between apps to copy-paste the username, then the password — but this is a lot of actions that take a lot of time.

Luckily, you can make KeePassium quickly fill in login forms for you. This is a great convenience feature that works in all apps and websites. However, it needs some initial setup:

  • Open device settings
  • Scroll down to Passwords & Accounts and press it
  • Select AutoFill Passwords
  • Turn on the AutoFill Passwords switch
  • Select KeePassium in the list
  • Now, open any webpage with a login form
  • Tap on the password input field. You will see your keyboard, with a Passwords button above it.
  • Press the Passwords button. This will open the KeePassium AutoFill screen.
  • Press Add Database button, navigate to your database in Dropbox and select it.

Now, whenever you press the Passwords button above the keyboard, you will see a list of accounts related to the current app. Press the account you need, and it will be automatically filled into the login form.

This guide is a work in progress. If you feel something is missing or could be improved — let us know.

KeePassium 1.08 — KeePass for iPhone, made easy

KeePassium 1.08 is here to make your iPhone KeePass workflow even smoother.

From now on, the Unlock button will stay out of your way, saving you a couple of seconds every day. When you open the app, it will ask you for a Touch ID/Face ID scan and take you directly to your passwords.

Switching between databases is also very easy:

Opening databases in KeePassium
KeePassium easily switches between databases

Auto-unlock is available both in free and premium versions. To disable it, simply turn off the “Remember Master Keys” option in the settings.

KeePassium 1.06.42

KeePassium 1.06.42 brings two visible improvements.

Gestor de contraseñas para iOS: KeePassium in Spanish

KeePassium is now available in Spanish! (Thanks to Juan_Net and NicolasCGN, who both contributed to the translation).

Overall, your favorite KeePass app for iOS now speaks 9 languages. Translate KeePassium to your language — everything is done online, no coding knowledge required.

KeePassium in Spanish
KeePassium in Spanish

Large text mode

KeePassium now fully respects the system text size settings, and looks much easier on the eyes.

To change the text size, open device settings — Display & BrightnessText Size. If this is not enough, try AccessibilityDisplay & Text SizeLarger Text.

Default and large text modes
KeePassium with default text size KeePassium with large text size

KeePassium Pro — for family and business

KeePassium Pro icon

KeePassium Pro is the premium version of KeePassium that is compatible with Family Sharing and Volume Purchase Program (VPP).

Family Sharing

When you have a family to protect, you’d want the premium experience for everyone. However, in-app purchases are not eligible for Family Sharing, so everyone needed a separate license. The resulting costs could quickly escalate from hefty to ridiculous.

KeePassium Pro solves this problem. It is a paid app that already includes all the premium features. A single purchase protects up to five users in your Family Sharing group.

Five for the price of one — how cool is that? :)

Better prices

Today’s release was a good moment to revise the price of the Premium Keeper — the permanent license available as in-app purchase. With the old license effectively replaced by KeePassium Pro, the new Premium Keeper now costs about 30$. This is a great option if you want a personal premium license.

The early adopters who purchased Premium Keeper at the original price can get a free upgrade to KeePassium Pro. Please follow instructions in the app.


Volume Purchase Program (VPP)

If your organization is enrolled in the Volume Purchase Program for Business — you can buy KeePassium Pro in volume and distribute the best KeePass app for iOS directly to your users.

No more personal purchases, reimbursement forms, or promo codes that were needed to activate the freemium edition. No recurring payments, either — it’s a one-time purchase.

KeePassium 1.02.36

After a month of undercover work, KeePassium is back with a new update. There are three notable highlights that will make your life better.

iOS 13: Dark Mode

KeePassium is now fully compatible with the iOS 13 Dark Mode.

Dark and Light mode
KeePassium in dark mode KeePassium in light mode

Passwort Manager, Wachtwoordbeheerder, 密码管理器, Менеджер паролей — call it what you like

Thanks to the awesome community of volunteers, KeePassium now speaks five more languages!

  • German — thanks to Lukas Wolfsteiner, Talwanderung, @cpktmpkt, danoe and robin-moser
  • Dutch — thanks to Heimen Stoffels (@Vistaus)
  • Chinese Simplified — thanks to 3374575857
  • Chinese Traditional — thanks to 3374575857
  • Russian — that’s on us :)
KeePassium, translated
KeePassium in six languages

To enjoy KeePassium in your native language, join the translation. No coding knowledge required.

Special thanks to the Crowdin folks who made their great platform available to open source projects.

User name generator/picker

KeePassium makes it very easy to have different passwords for each account. But what about user names?

Whether you always stick with the formal firstname.lastname or prefer randomness — we’ve got you covered!

When creating a new entry, tap Choose at the user name field. You will get a selection of the most frequently used names (from your database), plus a completely random one.

Two taps to fill the user name
Username selector/generator in KeePassium

First steps in KeePassium

For those who are new to KeePass and KeePassium, here’s a one-minute video on how to:

  • create a database
  • unlock the database
  • add a new entry with a strong random password
  • save changes
Video: First steps in KeePassium.

Introducing KeePassium for iOS

KeePassium icon

KeePassium is a password manager that combines the security of KeePass with the beauty of iOS design.

KeePassium was created because existing KeePass apps on iOS — such as MiniKeePass, KeePass Touch, Strongbox, KyPass, iKeePass — either ceased development (MiniKeePass, iKeePass) or lack the usability they could have.

KeePassium fills this gap. After 7 month of initial development, followed by 10 month of thorough beta testing and refinements, KeePassium is finally available on the App Store.

Privacy First

KeePassium is a premium app for those who value their privacy.

  • You can host your encrypted database wherever you want, whether it’s locally on device, in a cloud or your own server.

  • KeePassium never asks for your server credentials. All the networking is done by the original storage provider app. A password manager should never have full read/write access to your whole server.

  • There are no ads, no trackers, no analytics. If something does not work — tell us, otherwise we won’t know.

  • You don’t have to trust us — KeePassium is open source. Audit the source code, build your own binary and rely on it.

Features

  • Automatic sync — keep your database in your favorite cloud or offline (supports Dropbox, iCloud, Box, OneDrive, Google Drive, pCloud and more.)
  • Password AutoFill — login to any service in a few taps.
  • Unlock with Touch ID / Face ID.
  • Multiple databases — to share passwords with your team or family.
  • All database formats (kdb, kdbx3, kdbx4).
  • TOTP, custom icons, attachments, entry history, automatic backups…

And also:

  • No in-app browser.
  • No SSH/VNC client.
  • No crazy fonts or colors.
  • No coffee maker.
  • No ads.

Premium vs. Free

You can try KeePassium for free, indefinitely, and upgrade when it’s worth your time.

The free version provides everything a casual user would ever need: view, edit, sync, search, TouchID / FaceID unlock. There are some inconveniences, though: only one database can be used at a time, and that database will automatically lock up within 1 hour. Most people will be perfectly happy with the free version.

The premium version is designed for experts and business users who value their time and convenience. You can add multiple databases, quickly switch them with one-tap unlock, and preview attachments directly in the app. Premium subscriptions keep KeePassium open, ad-free and secure.

Download on the App Store

Discuss this post on Reddit


P.S. Almost by coincidence, today is the 5-year anniversary of KeePassB for BlackBerry 10. It was released on 31 July 2014 and became the best KeePass app for BB10 phones. Let’s see how this works out on iOS :)