Recovery
What you need to get back in
| You still have | What to do |
|---|---|
| Any trusted device (unlocked) | New device → sign in with the passkey → show the pairing code → approve it on the trusted device after comparing the 6-digit fingerprint. |
| The recovery kit (handle + recovery key) | New device → "Recover with recovery key". Then create a new passkey and rotate the recovery key. |
| An encrypted backup file + the recovery key that was valid when it was made | Readable offline (openBackup), restorable into any account. Works even if the server is gone. |
| Nothing of the above | The vault cannot be recovered — by anyone. This is the price of the server not being able to read it. |
The passkey alone (for example synced through iCloud Keychain) signs you in to the server but decrypts nothing.
The recovery kit
Shown once at account creation, and again whenever the key is rotated or the account is rekeyed. Print it (the
app has a print layout) or write it down; verify it by typing back the requested groups. Keep it offline: a safe,
a sealed envelope with someone you trust. Do not photograph it, do not store it in a cloud note, never type it
into anything except an SP Vault client. SPV1-XXXX-… (14 groups); a typo is detected locally by a checksum.
Rotation and rekey
- Rotate recovery key (Settings): new key, the old one stops working immediately. Do it after every use and whenever the kit may have been seen.
- Account rekey (Devices → danger zone): after a device was lost unlocked or compromised. New root key, new recovery key, new key epoch for every vault you own with all records re-encrypted, other devices signed out. Then change the passwords stored in the vault that matter most — the old device may have copied them.
Optional trusted-device quorum
Not implemented in SPV1. The supported redundancy is: several enrolled devices + the printed kit + encrypted backups.
Restore drill (do it; an untested backup is a hope)
- Settings → Export encrypted backup → keep the
.spvaultfile offline. - On another browser profile or device, recover the account with the kit, or create a throwaway account.
- Settings → Restore backup → pick the file (enter the recovery key that was valid at backup time if asked).
- Compare item counts and open a few items. Record the date in your notes. Repeat quarterly.
Backups contain items of all vaults you can read, not attachments (download those separately for now).