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
- Unlock your vault in Cryptomator.
- In Ledgerbook, open Settings and find Cryptomator vault backup.
- Click Find. If the vault isn’t found, click Reveal Drive in Cryptomator and paste that folder into Unlocked vault folder.
- Make sure Enabled is ticked, then click Save.
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.jsonis 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.