Repository navigation
Backup and Recovery
Password-Manager backup and recovery are designed around client-side encryption.
A backup file can be recovered with:
- the backup file
- the login password that was active when the backup was generated
- a compatible Password-Manager recovery page
No database connection is needed for recovery.
Log in and go to:
Settings -> Back Up
Click Start Backup.
If file attachments are enabled and you want to include them, check:
Include Files
Backup generation can take time. Do not close the browser tab until it finishes.
The downloaded file is usually named:
backup.txt
A backup requires the login password that was current when the backup was generated.
If you later change your login password, old backups still require the old login password.
After every login password change, generate a new backup.
Open the recovery page.
The recovery page is part of the frontend:
recovery.html
The recovery page works in the browser and does not require backend configuration.
Steps:
- Open
backup.txtin a plain text editor. - Find the backup version value, usually shown as
"VERSION":"...". - Use a Password-Manager recovery page from the same version whenever possible.
- Select
backup.txt. - Enter the login password that was active when the backup was generated.
- Start recovery.
- Wait for the browser to finish decrypting.
If the browser asks whether to stop the page because it is taking too long, choose to wait.
Use the same Password-Manager version as the backup whenever possible.
If your current recovery page cannot unlock an old backup:
- Find the version number inside
backup.txt. - Download that Password-Manager release.
- Open that release's frontend recovery page.
- Recover the backup there.
You do not need to configure backend config.php just to use recovery.
After successful recovery, the recovery page can export:
- CSV
- RAW
CSV is useful for migrating to other password managers.
CSV export does not include:
- attached files
- password history information
- all internal metadata
Treat the CSV file as sensitive plaintext-equivalent data.
RAW export is intended for migration between Password-Manager instances.
RAW can contain the full clone data needed for import into another Password-Manager instance. If the backup included files, RAW export may include file data.
Treat RAW files as sensitive plaintext-equivalent data.
Recommended migration flow:
- Generate
backup.txt. - Open the recovery page.
- Unlock the backup.
- Export RAW.
- Log in to the destination Password-Manager instance.
- Go to
Settings -> Import. - Import the RAW file.
Importing RAW adds entries to the destination account. For a clean clone, import into an empty account.
- Generate backups regularly.
- Store at least one backup offline.
- Store the login password or a recovery procedure securely.
- Delete temporary CSV and RAW files after migration.
- If compromise or data loss was caused by an attack, change the affected saved passwords after recovery.