Documentation

Cloud Sync

Knosys encrypts workspace record and attachment payloads before sync upload. The service also processes account, device, routing and delivery metadata. The next release is under development; physical-device and hosted-service acceptance remain prerequisites for its public sync launch.

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. Compatible changes merge; conflicts that need a decision remain available for review

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

The sync server is developed in the Knosys monorepo. A public self-hosting release and installation guide have not yet been qualified. Do not use an unverified repository or replace a live server’s data to try a development build.

Privacy & Security

• End-to-end encryption — workspace content payloads are encrypted before upload
• Service metadata — account/device identifiers and delivery metadata are processed separately from encrypted content
• Self-hosting — public release instructions remain in preparation
• Local-first — Knosys works fully offline, sync is optional
• Account deletion — local reset does not delete hosted account or server records; that is a separate support workflow