OmniDock GitHub

$ man omnidock/troubleshooting

Troubleshoot OmniDock Setup, Mail, Sync, and R2

Troubleshoot common OmniDock issues: missing D1/R2/Email bindings, Cloudflare API errors, Email Routing problems, Email Sending failures, Gmail sync errors, and R2 preview/search issues.

Setup screen shows missing bindings

Confirm the Worker has DB, MAIL_BUCKET, EMAIL, and ASSETS. Then confirm build variables include OMNIDOCK_D1_DATABASE_ID and OMNIDOCK_R2_BUCKET_NAME so future deploys keep those bindings.

Inbound mail is not appearing

  • Check that Email Routing is enabled on the Cloudflare zone.
  • Confirm the mailbox rule or catch-all points to the correct Worker.
  • Check Logs for parse, D1 write, or R2 write errors.
  • Verify the primary domain and Worker script name variables if automation is used.

Sending fails

For Cloudflare-managed senders, verify Email Sending status and that the From address exists as an enabled mailbox in D1. For external SMTP, verify host, port, TLS mode, and the Worker secret reference.

R2 preview or search is incomplete

Path and filename search should be fast. Text search works for text files, searchable PDFs, and saved text indexes. Scanned PDFs and images need the OCR-ready index flow before their contents can be found.