User Guide

Reference documentation for every feature

Guide navigation

Sync & Backup

OikoNotes provides multiple ways to back up and synchronise your data across devices.

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 syncs through OikoNotes Cloud and Copepod-backed storage. Desktop can stay local-only, or use account-backed sync features when configured.

Push

Send your local changes to the remote database. All notes modified since the last sync are uploaded.

Pull

Download changes from the remote database. Notes modified on other devices are applied locally.

Conflict Resolution

When the same note has been modified on multiple devices, a conflict occurs. OikoNotes presents three resolution options:

OptionBehaviour
Keep LocalDiscard the remote version and keep your local changes
Keep RemoteDiscard your local changes and accept the remote version
MergeAttempt to combine both versions, preserving changes from both

LibSQL / Turso

Earlier local sync experiments used LibSQL or Turso-style remote databases. The hosted product path now uses OikoNotes Cloud for account-backed sync while keeping export available as the portability fallback.

Database Backends

BackendUse Case
SQLiteDefault local-only storage. Simple, no setup required.
LibSQLRemote sync with replication. Use for multi-device access.

Data Safety

Your notes are stored locally in SQLite. The database file is at the path configured in OIKONOTES_DB_PATH. Regular ZIP exports provide an additional backup layer.