Skip to content

Vault and encryption

How your encrypted vault is protected by default, and how to lock it with your account password or a master passphrase.

On this page

One encrypted vault#

Ravelon stores your connections, login details, imported keys, snippets and settings in a vault encrypted with AES-256-GCM. When saving, it keeps the previous file until the new one is fully written. You can add a password lock for protection on your computer, as described below.

How the vault is opened#

Settings → Security shows how your vault is protected:

ModeBehaviour
Automatic (default)The key sits in a key file beside the vault. Ravelon opens without asking.
Encryption password lock (opt-in)The key is derived from your sync encryption password with Argon2id, and the automatic key file is removed. You can explicitly remember it on this device.
Master passphrase (opt-in, no account needed)The same, with a passphrase chosen only for this vault.
Important: Automatic mode encrypts the vault file, but its key file is beside it. Anyone who can read both files can open the vault, including a backup or synced folder containing both. It also does not protect against software running under your user account. For password protection, turn on a lock.

Turn on the lock#

First unlock sync with your encryption password under Settings → Account & sync. Then switch on Require the encryption password at launch under Settings → Security → Lock. This uses the separate sync encryption password, not your account sign-in password. Ravelon cannot reset it: without it, or a remembered copy on this device, the vault cannot be opened. You can explicitly remember it on one device to open without asking there.

On a device that never signs in, choose Protect the vault with a separate passphrase instead. The passphrase needs at least 8 characters.

Lock and auto-lock#

With a lock turned on, lock the vault with Lock vault in the menu behind your avatar, or with ⌘⇧L on macOS or Ctrl+Shift+L on Windows and Linux. Lock automatically locks the vault after 5 minutes to 4 hours without input in Ravelon, and when the computer wakes after a longer sleep. Locking closes every SSH session with its tunnels and file transfers, and every remote desktop.

If the vault cannot be opened#

Ravelon then shows a recovery screen with these options: try again, reveal the folder, or start over. Starting over archives the unreadable file next to the new one. Nothing is deleted.

Last updated 12 November 2026