Skip to main content
Knosys

Documentation

Cloud Sync

Knosys Cloud Sync lets you keep your data synchronized across all your devices with end-to-end encryption. Your data is encrypted on your device before it ever leaves — not even the sync server can read it.

How It Works

Knosys uses a local-first sync architecture:

  1. You make changes locally — they're saved instantly to your device
  2. Changes are encrypted on your device using your sync key
  3. Encrypted data is uploaded to the sync server
  4. Other devices download and decrypt the changes
  5. Conflicts are resolved automatically

Setting Up Sync

1. Create an Account

Open Knosys Settings and navigate to the Sync tab. Click ‘Create Account’ and follow the prompts.

2. Save Your Sync Key

You'll receive a sync key — a passphrase that encrypts your data. Store this somewhere safe. If you lose it, your synced data cannot be recovered.

3. Connect Your Devices

On each additional device, install Knosys, go to Settings > Sync, and sign in with your account. Enter your sync key when prompted.

Self-Hosting

If you prefer to run your own sync server, Knosys supports self-hosting.

# Clone the sync server
git clone https://github.com/knosys-app/sync-server

# Install dependencies
npm install

# Configure environment
cp .env.example .env
# Edit .env with your settings

# Start the server
npm start

Point your Knosys client to your self-hosted server in Settings > Sync > Server URL.

Privacy & Security

  • End-to-end encryption — the server never sees your plaintext data
  • Zero-knowledge architecture — we can't read your data even if we wanted to
  • Open-source sync server — audit the code yourself
  • Local-first — Knosys works fully offline, sync is optional
  • Delete your account anytime — your local data remains untouched