How to Migrate from Vaultwarden to VaultKeepR
Use the steps below to export from Vaultwarden and import locally in VaultKeepR. Keep the source vault until you have checked the imported entries.
Scope of this guide: this page covers exporting your personal vault from an existing Vaultwarden instance and importing it into VaultKeepR. It does not cover moving or migrating a Vaultwarden server itself (see the short note at the end of this page).
Follow these steps :
Section titled “Follow these steps :”- Log in to the Bitwarden web vault connected to your Vaultwarden server (Vaultwarden has no app of its own; it uses Bitwarden clients).
- Go to Tools > Export Vault.
- Select the unencrypted JSON format. JSON preserves more item types than CSV, and VaultKeepR cannot import an encrypted (password-protected) export.
- Enter your master password to decrypt and download.
- Vault exports do not include file attachments — download any attachments separately if you need them.
- In VaultKeepR, open Settings → Data → Import and select the JSON file. Parsing happens locally; nothing is uploaded.
- Verify the import preview, confirm the merge, then check entry counts and spot-check credentials before deleting the export file.
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”Vaultwarden is a self-hosted server compatible with Bitwarden clients. You control its hosting and backups. Importing a personal vault into VaultKeepR does not move that server: synchronization then uses the storage services configured in VaultKeepR, with their own availability limits.
Processing entries on device
Section titled “Processing entries on device”The import runs in the VaultKeepR app on your device:
- The unencrypted Bitwarden JSON 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.
Moving a Vaultwarden Server (Out of Scope)
Section titled “Moving a Vaultwarden Server (Out of Scope)”Moving a Vaultwarden server to another host — backing up its SQLite database (db.sqlite3), copying attachments, and restoring it in a new container — is a server administration task, not a password manager migration. It is out of scope for this guide. Refer to the official Vaultwarden project documentation for backup and restore procedures.
Frequently Asked Questions (FAQ)
Section titled “Frequently Asked Questions (FAQ)”What export formats does VaultKeepR support?
Section titled “What export formats does VaultKeepR support?”Use an unencrypted Bitwarden JSON export of your personal vault. This does not import a Vaultwarden SQLite database or its attachments; download attachments separately.
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.