KeePassXC + KeySigner

Plan how to open and recover a local KeePassXC database when a device is unavailable.

What to check first

Copy a disposable database, identify its required unlock factors and verify that an authorized user can restore and open the copy.

Choose a KeySigner setup

Setup guide What it does and what to keep available
Test copying a time-based code from KeePassXC →

Copy one time-based code into KeySigner while keeping the original entry in KeePassXC.

You need KeySigner macOS build with password-manager import enabled.

Keep available The original vault and the service’s independent account recovery method until the copy works.

Create and recover a test database key file →

Add a key file alongside the database password and test whether you can restore a usable copy.

You need KeySigner macOS test build with local key file commands and KeePassXC 2.8.0.

Keep available The original test database and key file until you confirm recovery. Keep the encrypted backup, its passphrase and the database password accessible.

KeySigner setup requirements →

Check the version →

Compare sign-in code imports →

What it covers

Access to a synced copy of the file does not unlock the database.

Make an offline recovery plan →

Troubleshooting

Does the copied database refuse to open after moving devices?

Check which factors unlock the original test database. If it uses a key file, verify that the copied key file is available and still matches.

Check that KeePassXC can open the intended database file. If it is stored in a synced folder, check which copy the device has before trying recovery.

Find documentation and support →

Documentation and support

KeePassXC documentation

Check database unlock factors and recovery

KeySigner setup help

Ask about this setup →