5 min read

How Zyler Sync encrypts your notes

Your pages and attachments are encrypted on your device before they upload. Here is what that means, where the keys live, and what Zyler's server can and cannot see.

Zyler Sync is end-to-end encrypted. Your pages and attachments are encrypted on your device before they upload. Zyler's server only ever stores the encrypted data, so it cannot read your notes. This article explains how that works in plain words.

The short version

  • Each page and attachment is encrypted on your device with AES-256-GCM.
  • Your keys live on your devices. The server only holds copies it cannot unlock.
  • A new device joins when you approve it from a device you already use, or with your recovery key.
  • You get one recovery key. Without it or a device, nobody can recover your notes, and that includes us.

What happens when you edit a page

  1. You edit a page on your Mac. The page is a normal file in your vault folder.
  2. Zyler encrypts the page on your Mac, then uploads the encrypted data.
  3. The server stores it and tells your other devices that something changed.
  4. Your iPhone downloads the encrypted data and decrypts it on the phone.

Plain text exists only on your devices. The server sits in the middle and never holds anything it can read.

Encrypted on your device

Zyler uses AES-256-GCM, a widely used encryption standard. Every time a page or attachment is encrypted, Zyler uses a fresh random value, so two copies of the same page never look alike. The encrypted data is also tied to the vault, the record and its version. That stops the server from swapping one piece of data for another or handing you an old version as if it were new.

Large attachments are cut into 4 MiB pieces and each piece is encrypted on its own, so an upload can resume after a break.

Where the keys live

Zyler uses three keys.

  • Account key. Zyler makes it on the first device where you turn on Sync. It lives on your devices, stored with your Zyler sign-in on that device.
  • Vault key. Each vault has its own. The server stores it only after it has been locked with your account key.
  • Recovery key. It is shown once, when you first turn on Sync. It locks the copy of your account key that the server holds, and it is the only thing that can unlock that copy.

The server never gets a key it can use. You cannot choose your own encryption password, which keeps a weak password from becoming the weakest link.

Adding a new device

When you sign in on a new device, it asks your account to approve it.

  1. The new device sends a request through the server.
  2. A device you already use shows that a new device wants to join.
  3. Both devices show the same six digit code.
  4. You check that the codes match and confirm on both devices.
  5. Only then does the old device pass the account key to the new one, locked so that only the new device can open it.

The code protects you from someone in the middle, including the server. If the codes do not match, you reject the request. A request lasts 10 minutes, and you can send it again.

You can also add a device with your recovery key when no other device is at hand.

The recovery key

You get one recovery key when you first turn on Sync, and Zyler asks you to save it before anything uploads. After that it is not shown again. You can make a new one in Settings, and the old one stops working.

If you lose every device and you do not have the recovery key, the data on the server cannot be decrypted. That is the cost of end-to-end encryption. The vault folder on each of your computers is still a complete copy of your notes.

What the server can and cannot see

The server cannot see:

  • Page titles
  • Page text
  • Your page tree
  • Attachment names
  • Vault names

The server can see:

  • Your account
  • An ID, a type, a size and a version for each record
  • Which device uploaded each record, and when

Each page is padded to a multiple of 4 KiB before it is stored, so its size says less about what is inside. The server also keeps earlier versions of each record, and those are encrypted the same way.

What this does not cover

Removing a device stops the server from serving it new data and signs it out. It cannot take back keys the device already holds, so a removed device that was offline can still read what it has already downloaded.

Zyler's server cannot read your notes, but your devices can. Keep your devices locked and your recovery key somewhere safe.

Learn more

Keep reading

View All