Desktop App
The Dokyo desktop app gives you a native experience with offline support. Edit pages and databases without internet; changes sync automatically when you reconnect.
The Dokyo desktop app is a lightweight native client for Windows, macOS, and Linux. It loads the same workspace you use in the browser, with an added benefit: offline support. When your internet connection drops, you can keep reading and editing. Your changes sync automatically when connectivity returns.
Installing the app
Head to the Download page and grab the installer for your platform:
- Windows:
.exe(NSIS) or.msiinstaller. - macOS:
.dmgfor Apple Silicon (M1/M2/M3) or Intel. - Linux:
.AppImage(runs on most distros) or.debpackage.
After installing, launch Dokyo and log in with your existing account. If you do not have an account yet, sign up free.
Working offline
When the desktop app fetches data from the server, it stores a copy in a local database on your computer. If the server becomes unreachable (no internet, server maintenance, etc.), the app switches to this local cache transparently:
- Reading: pages, databases, and favorites are served from the local cache.
- Writing: new pages, edits, and database row changes are saved locally and queued for sync.
- Rich text editing: the editor uses Yjs (a CRDT library) so offline edits merge automatically with server changes, with no conflicts.
A small status indicator in the bottom-left corner of the app tells you the current state:
| Indicator | Meaning |
|---|---|
| Green dot | Online, all data synced |
| Amber dot (pulsing) | Syncing pending changes |
| Gray dot | Offline |
| Red dot | Sync error (click for details and retry) |
What works offline
| Feature | Online | Offline |
|---|---|---|
| View and edit pages | Yes | Yes |
| Create and delete pages | Yes | Yes (queued) |
| Database table, kanban, chart | Yes | Yes (cached) |
| Edit database rows | Yes | Yes (queued) |
| View cached images | Yes | Yes |
| Upload images | Yes | Queued, uploaded on reconnect |
| Search | Full-text | Titles only |
| Export PDF | Yes | Yes |
| Real-time collaboration | Yes | No (merges on reconnect) |
| AI assistant | Yes | No |
| Notifications | Yes | No |
Sync and conflict resolution
When connectivity returns, the app replays all queued changes against the server in the order they were made. For most data (titles, icons, database rows), last-write-wins is used: the most recent edit takes precedence.
For rich text content, the editor uses a CRDT (Yjs), which means offline edits are merged character-by-character with any changes made on the web or other devices. No data is lost, and no manual conflict resolution is needed.
Auto-updates
The desktop app checks for new versions on launch. When an update is available, it downloads and installs automatically, then relaunches the app. You always have the latest features and bug fixes without manual downloads.
Data storage
The local cache is stored in your system's standard app data directory:
- Windows:
%APPDATA%\dokyo\ - macOS:
~/Library/Application Support/dokyo/ - Linux:
~/.local/share/dokyo/
Cached files (images, attachments) have a configurable size limit (default 500 MB) with automatic eviction of files not accessed in 30 days.