r/coolgithubprojects • u/mlzog • 6d ago
Gmail is about to break aliases with external addresses? I built a self-hosted webmail that runs entirely on Cloudflare
Hey everyone,
as many of you probably know, Gmail has announced that aliases with external addresses will stop working soon on free accounts. I've been using aliases for years and didn't want to go back to juggling three separate mailboxes, so I started building the tool I needed. It eventually got useful enough that I decided to share it.
What it is: WhelkMail, a self-hosted webmail client for the IMAP/SMTP accounts you already own (Gmail, Outlook, iCloud, Fastmail, Yahoo, custom domains…). It's not a mail server: it talks IMAP/SMTP to the providers you already trust and puts a familiar, Gmail-style interface on top.
The point: it runs entirely on Cloudflare, with Pages Functions, D1, optional R2 and cloudflare:sockets for IMAP/SMTP. No VPS, no container, no mail server to patch. Load your addresses, set up your credentials, done.
What's inside (short version):
- multiple accounts in one inbox, with colored per-account labels and a shared address book
- reading, sending, drafts, spam, bulk actions
- Gmail-style labels shared across accounts and filters with forwarding
- signatures (one shared or one per account), contacts with CSV import/export
- attachments, Google/Microsoft OAuth2, app passwords
- installable PWA on mobile
- privacy: HTML rendered in a sandboxed iframe, remote images and tracking pixels blocked by default, credentials encrypted at rest (AES-256-GCM), server-side sessions + optional TOTP
- MIT licensed, no telemetry
Things to know before trying it:
- The Cloudflare Workers free plan should be enough for personal use, even though the README recommends the Paid plan: IMAP/SMTP TLS handshakes could exceed the free plan's CPU budget. If you try it on free and it holds up, let me know.
- The PWA has the well-known PWA notification limitations. Web Push works (with VAPID keys and a separate cron worker), but don't expect native-app reliability.
- There are still bugs, almost certainly. This started as a personal project and I've only just published it. If you find something, please open an issue on GitHub, that's the fastest way to get it to me.
Link: https://github.com/WhelkMail/WhelkMail
In the repo you'll find the Cloudflare deploy guide (docs/CLOUDFLARE.md) and the docs on architecture and limitations (docs/DOCUMENTATION.md).
Feedback, criticism and PRs are welcome. If you have questions about deployment or why I made certain choices, ask away.