Skip to content

A self-hosted email client with an AI agent, running entirely on Cloudflare Workers

TypeScript

Clarify Access troubleshooting in README

Thomas Gauvin0889886fd28f
diff --git a/README.md b/README.md
index 8de25da..bce3d72 100644
--- a/README.md
+++ b/README.md
@@ -27,6 +27,13 @@ Click the button above to deploy to your Cloudflare account. The deploy flow wil
3. **Create a mailbox** -- Visit your deployed app and create a mailbox for any address on your domain (e.g. `[email protected]`)
4. **Configure Cloudflare Access** -- Enable [one-click Cloudflare Access](https://developers.cloudflare.com/changelog/post/2025-10-03-one-click-access-for-workers/) on your Worker under Settings > Domains & Routes. The modal will show your `POLICY_AUD` and `TEAM_DOMAIN` values. `TEAM_DOMAIN` can be either your Access team URL or the full `.../cdn-cgi/access/certs` URL. **You must set these as secrets for your Worker.**
+### Troubleshooting Access
+
+1. If you see `Invalid or expired Access token`, that usually means `POLICY_AUD` or `TEAM_DOMAIN` secrets are incorrect.
+ * Resolution: turn Access off and back on for the Worker to get the Access modal again with the variables, then reset your Worker secrets to the latest `POLICY_AUD` and `TEAM_DOMAIN` values shown there.
+2. If you see `Cloudflare Access must be configured in production`, this application is intentionally enforcing Cloudflare Access so your inbox is not exposed to anyone on the internet.
+ * Resolution: enable Access using [one-click Cloudflare Access for Workers](https://developers.cloudflare.com/changelog/post/2025-10-03-one-click-access-for-workers/), then set the `POLICY_AUD` and `TEAM_DOMAIN` Worker secrets from the modal values.
+
## Features
- **Full email client** — Send and receive emails via Cloudflare Email Routing with a rich text composer, reply/forward threading, folder organization, search, and attachments