Import from KeePass
When migrating from KeePass, you can choose which file type to import in to Bitwarden:
Import an encrypted KeePass
.kdbxfile, secured with a password and an optional key file.Import a
.csvor.xmlfile from KeePass2 or KeePassX.
note
While some item types cannot be imported, you can still add them to a vault:
Upload file attachments to the new vault individually.
Re-create Sends in the new vault.
The steps to export from KeePass may differ based on your version. To export data from KeePassXC on macOS, for example:
.kdbx: Go to Database → Save Database As. Enter a file name and select Save..csvor.xml: Go to Database → Export. Select Yes to confirm the export, enter your password, and select Unlock.
After exporting your KeePass data, follow the steps that match your file type.
This option may be preferred because it creates an encrypted file, which you can protect with a password or key file. You can use the Bitwarden web app, browser extension, desktop app, or CLI.
note
When using the CLI to import a .kdbx file, you will be prompted to enter your KeePass password and, if added to your KeePass database, its key file path.
To import a .kdbx file to your Bitwarden vault:
In the Bitwarden web app, browser extension, or desktop app, open the Import page:
Web app: Go to Tools → Import.
Browser extensions: Go to Settings → Vault options → Import.
Desktop apps: Select Import from the navigation.
From the Vault dropdown menu, select where to save the data:
To save data in your personal vault, select My vault. (Optional) Choose an existing Folder to organize the imported items.
note
When you import KeePass data to My vault, any KeePass groups you may have set up will be migrated as Bitwarden folders. If you also choose a Folder when importing the file, the imported folders will be nested inside the folder you selected.
To save data in an organization's vault, select the organization's name. (Optional) Choose a Collection to organize the imported items and share with other members. (You can only choose a collection where you have can manage permission.)
note
When you import KeePass data to an organization vault, any KeePass groups you may have set up will be migrated as Bitwarden collections, nested within the collection you chose as a destination for the import.
From the File format dropdown menu, select KeePass (kdbx).
Enter your KeePass master password.
If you added a key file within your KeePass database security settings:
Select Add key file.
Within Key file upload, select Choose File and pick your export's key file. The file name will end with
.keyx.
Within KDBX file upload, select Choose File and pick your export's file. The file name will end with
.kdbx.Select Import.
After your data is imported, delete the exported data file from your computer. This will protect you in the event your computer is compromised. You may want to also delete your data from KeePass.
note
If your file contains any KeePass fields where the advanced setting Protect value in process memory was applied, it becomes a hidden field in your Bitwarden vault.