Skip to content

Recovery Key & Rotation

What the recovery phrase is for, where to find it, and when to rotate the vault key.

Recovery Phrase

A list of words generated at vault creation. It's the only way to decrypt your data if you:

  • Forget your passphrase
  • Lose every device that has the vault key sealed for it

memrynote never stores the recovery phrase in the cloud. It exists only where you save it.

Where to Save It

Pick at least one of:

  • Password manager (1Password, Bitwarden, etc.) — recommended
  • Written down in a safe place
  • Printed and stored physically

Don't screenshot it on a synced phone, email it to yourself, or paste it in a sticky note app — those defeat the purpose.

Re-Displaying the Recovery Phrase

You can re-show the recovery phrase from Settings → Account → Security:

  1. Click Recovery Key
  2. Confirm your passphrase
  3. The phrase displays. You can copy it (briefly to clipboard) or write it down.

The display screen has a 60-second auto-clear so you don't accidentally leave it visible.

Restoring with Recovery

If you lose every device:

  1. Install memrynote on a fresh device
  2. Choose Restore from recovery phrase during setup
  3. Enter the words in order
  4. Set a new passphrase (the recovery phrase + new passphrase regenerates the wrapping key)
  5. The device pulls and decrypts your vault

The recovered device is treated as a new linked device.

Key Rotation

The rotation wizard generates a new vault key, re-encrypts all payloads under it, and reseals the new key for every linked device.

When to Rotate

SituationRotate?
Lost or stolen device that wasn't revoked yetYes — immediately
Recovery phrase exposedYes
Major OS or backup compromiseYes
Suspect API key leakNo (rotate the API key, not the vault key)
Routine maintenanceOptional; rotation is safe but takes time

Running Rotation

  1. Settings → Account → SecurityRotate Keys
  2. Confirm your passphrase
  3. The wizard:
    • Generates a new vault key
    • Re-encrypts payloads (streamed; resumable)
    • Reseals the new key for each linked device
    • Bumps crypto_version on sync items

For large vaults, rotation can take a while. It's safe to interrupt — the wizard resumes from the last checkpoint.

Effects

  • Old sealed keys on revoked devices are now useless even if they were exfiltrated
  • The new key is unknown to the server (it sees only ciphertext)
  • The recovery phrase remains valid (rotation doesn't reset it)

Recovery Phrase vs Passphrase

Recovery phrasePassphrase
What it doesRe-derives the wrapping keyDaily sign-in
When you use itAfter losing accessEvery sign-in
How often it changesAlmost neverWhenever you want
Where it livesOff-device, manualIn your head

Changing your passphrase doesn't invalidate the recovery phrase or the vault key — it only re-encrypts the wrapping key against the new passphrase.

See Also

Released under the GNU GPL v3.0.