Provider profiles
External accounts let OmniDock document and sync Gmail, Outlook, Yahoo, iCloud, or custom IMAP/SMTP mailboxes. Each profile stores provider, email, display name, inbound/outbound state, host, port, security mode, notes, secret reference, last checked time, last error, and sync status.
Gmail settings
Do not use a normal Google password. Gmail requires App Password or a supported OAuth secret approach. Two-Step Verification must be enabled before creating an App Password.
| Setting | Value |
|---|---|
| IMAP host | imap.gmail.com |
| IMAP port | 993 |
| IMAP security | SSL |
| SMTP host | smtp.gmail.com |
| SMTP port | 587 |
| SMTP security | STARTTLS |
Sync model
When a user starts sync, OmniDock creates a D1-backed job and begins a short immediate run. Cron triggers continue queued jobs. Cursor state stays in D1, so browser refresh or closing the tab should not cancel the sync. The status bar should show checked, imported, skipped, and error state, while Logs keep the diagnostic trail.