Sync & Backup
OikoNotes gives you a hosted sync path for web access and a local export path for keeping your own backups.
Export
Single Note Export
Export individual notes as Markdown files from the note editor.
Bulk Export
Export your entire vault as a ZIP file from Settings > Export & Backup. The ZIP contains all notes as Markdown files.
Cloud Sync
The hosted web app stores account data in OikoNotes Cloud through Copepod-backed storage. The Linux desktop app can stay local-only, or connect to the same account-backed sync path when configured.
Desktop to cloud
When desktop sync is enabled, local changes are sent through the OikoNotes sync service instead of writing directly to a remote database.
Cloud to desktop
Changes from the cloud account can be applied to the local desktop store so offline work and browser access can meet in the same workspace.
Conflict Handling
Conflict detection is part of the sync data model. The current product path prioritizes account-backed sync and explicit export; when a conflict cannot be applied automatically, keep an export backup before choosing which copy to keep.
Earlier LibSQL experiments
Earlier local sync experiments used LibSQL or Turso-style remote databases. The hosted product path now uses OikoNotes Cloud and Copepod-backed storage, while export remains the portability fallback.
Database Backends
| Backend | Use Case |
|---|---|
| SQLite | Default desktop storage. Simple, local, and exportable. |
| Copepod | Hosted account storage, cloud sync, auth, billing, and web access. |
Data Safety
Desktop notes are stored locally in SQLite at the path configured by OIKONOTES_DB_PATH. Regular ZIP exports provide an additional backup layer and a practical exit path.