Ledgerbook
v1.22

Guides / Your data

Encrypted backup to a Cryptomator vault

On Linux, keep an always-fresh, encrypted copy of your book inside a Cryptomator vault.

Cryptomator is a free program that keeps a folder encrypted. While you have it unlocked, the folder appears as an ordinary drive. Ledgerbook can copy your book into that drive every time something changes, so the copy that sits on your disk, or syncs to your cloud storage, is always encrypted.

This feature is in Ledgerbook for Linux only.

Turn it on

  1. Unlock your vault in Cryptomator.
  2. In Ledgerbook, open Settings and find Cryptomator vault backup.
  3. Click Find. If the vault isn’t found, click Reveal Drive in Cryptomator and paste that folder into Unlocked vault folder.
  4. Make sure Enabled is ticked, then click Save.
Settings with the vault unlocked and backing up

If exactly one vault is unlocked when Ledgerbook starts, it is used without you doing anything. If several are unlocked, Ledgerbook waits for you to choose, so a backup never lands in a vault you didn’t pick.

Choose the unlocked drive

Pick the drive that appears when the vault is unlocked, not the folder where Cryptomator stores its encrypted files. Ledgerbook refuses that folder.

What gets written

Ledgerbook makes a folder called Ledgerbook Backups inside the vault:

  • ledgerbook-latest.json is updated about 30 seconds after every change
  • a dated snapshot is added when Ledgerbook starts, every hour, when you click Back up now, and when you quit. The last 60 are kept

The badge beside your business name

Badge Meaning
Green, Vault and a time Backed up. The time is when
Amber, Vault locked The vault is locked. Ledgerbook is waiting and will catch up when you unlock it
Red, Vault error Something went wrong. Hover over the badge to see what
Grey, Vault backup off Not set up, or switched off

Click the badge to open the vault settings.

Why it only writes when the vault is unlocked

When a vault is locked, the place where it normally appears is just an empty folder. Writing there would leave an unencrypted copy on your disk. So Ledgerbook checks that the folder really is an unlocked vault before every write, and waits if it isn’t.

Get your book back from the vault

Unlock the vault, choose Backup & export, then Restore or open…, and pick ledgerbook-latest.json or one of the dated snapshots in Ledgerbook Backups.

If it keeps saying “locked”

  • Check that the vault is unlocked in Cryptomator.
  • Ledgerbook expects Cryptomator’s default FUSE volume type. If your vault is mounted another way, such as WebDAV, open ~/.local/share/ledgerbook/config.json, set "requireEncryptedMount": false, and start Ledgerbook again.
  • To make Find look only for a vault with a certain name, set "name": "YourVault" in the same file.