Skip to main content

Sync

Sync all your documents to a local SQLite database. This is required before using search, tasks, or export.

Usage​

umka sync

This performs a one-time sync of all documents and exits.

Watch mode​

Keep the connection alive and sync updates in real-time:

umka sync --watch

Options​

--server <url>    Server URL (defaults to stored credentials)
--token <token>   API token (falls back to stored credentials)
-w, --watch       Keep connections alive and sync in real-time

How it works​

Documents are synced via WebSocket using the CRDT sync protocol. Each document is stored as a separate SQLite database in ~/.cache/umka/, which enables fast local search and offline access.