How to Migrate from KeePass to VaultKeepR
Use the steps below to export from KeePass and import locally in VaultKeepR. Keep the source vault until you have checked the imported entries.
Follow these steps :
Section titled “Follow these steps :”- Open KeePass client.
- Go to File > Export > Active Database.
- Select the XML format (KeePass 2.x) — it preserves more fields than the CSV export.
- Save the database export.
- In VaultKeepR, open Settings → Data → Import and select the file. Parsing happens locally; nothing is uploaded.
Local encryption and its limits
Section titled “Local encryption and its limits”The VaultKeepR app reads the export on your device without uploading the import file. Vault data is encrypted with XChaCha20-Poly1305 before synchronization.
Storage operators receive ciphertext, but metadata remains visible. Availability depends on storage services, IPFS gateways and pinning. A compromised device can expose keys or plaintext. The threat model describes these limits.
Storage and transfer scope
Section titled “Storage and transfer scope”KeePass stores a .kdbx database wherever you choose. VaultKeepR also encrypts on device and synchronizes the encrypted vault when you enable sync. In either case, keep a backup and protect the devices that decrypt your data.
Processing entries on device
Section titled “Processing entries on device”The import runs in the VaultKeepR app on your device:
- The KeePass 2.x XML, or limited CSV file is read locally to map fields into vault entries.
- The imported vault is encrypted on device before synchronization.
- If you enable sync, storage services receive the encrypted vault, not the export file.
Precautions during transfer
Section titled “Precautions during transfer”An unencrypted export contains plaintext credentials. Use a trusted, updated device and keep temporary files out of shared or synchronized folders.
Check entry counts, sample credentials and important fields in VaultKeepR before deleting the export or a temporary list. Keep the source vault until these checks are complete. Deleting a file or emptying the trash does not guarantee physical erasure, particularly on SSDs or in cloud backups.
Frequently Asked Questions (FAQ)
Section titled “Frequently Asked Questions (FAQ)”What export formats does VaultKeepR support?
Section titled “What export formats does VaultKeepR support?”Prefer KeePass 2.x XML. Export it from the local .kdbx database first; this guide does not import the .kdbx file directly. CSV preserves fewer fields.
Can VaultKeepR help me recover my master password?
Section titled “Can VaultKeepR help me recover my master password?”VaultKeepR cannot reset your master password or decrypt your vault for you. Configure fragmented recovery before you lose access. It requires the recovery identifier, the encrypted vault or its manifest, and the configured quorum: 3 valid fragments out of 5 in the apps. Test the procedure with a test vault; it does not guarantee recovery if the required material is lost.