dripnex.docs
Guide

Cloud Sync

Optional end-to-end encrypted sync across devices

Cloud Sync

Dripnex works offline. Sync is optional. You never need an account to take notes.

Authentication

Magic-link email via api.dripnex.app. No password.

  1. Open Settings → Account
  2. Enter your email
  3. Open the link
  4. If you want cloud sync, create an encryption passphrase (Set up in the footer)

Without a passphrase there is no content-encryption key. Sign-in alone does not upload notes.

How Sync Works

  • SQLite on disk is the source of truth
  • Desktop SyncService encrypts each change with AES-256-GCM (CEK from your passphrase)
  • api.dripnex.app stores ciphertext. The Worker cannot read markdown
  • Auto-sync runs in the background while you are signed in and have a CEK
  • Offline edits wait locally and push when the network returns

Sync Status

The footer shows the current state:

StatusMeaning
SyncedLocal and cloud agree
SyncingPush or pull in flight
OfflineNo network; changes stay local
ErrorOften a missing passphrase — use Set up

Privacy

  • Plaintext never leaves the machine
  • You can keep using the app signed out
  • Signing out does not delete local notes

Troubleshooting

Sync error after sign-in

Create the encryption passphrase (Set up). Retry is a no-op until a CEK exists.

Notes missing on another device

Same account, same passphrase, wait for the first pull.

On this page