Self-hosted team chat running on Cloudflare Workers, with realtime messaging, a two-way Telegram bridge, and server-side encrypted messages and files.
- Stars
- 14,798
- Forks
- 22,555
- Open issues
- 92
- Last commit
- 24 hours ago
What is it?
Cloud Mail is a lightweight email service that runs on Cloudflare Workers. With one domain you can create many separate mailboxes, similar to mainstream webmail platforms, without maintaining your own mail server.
The stack uses Cloudflare D1 as the database, R2 for attachment storage, and KV for caching, with Hono as the web framework, Drizzle as the ORM, and a Vue 3 with Element Plus front end. Email sending is integrated with Resend, and incoming mail can be forwarded to a Telegram bot or another mailbox. Administrators can manage users and mail with RBAC-based permissions and resource limits.
The project also provides an open API for batch user creation and multi-condition mail queries, uses Workers AI to recognize verification codes in emails, and integrates Turnstile to limit bot registrations.
Key features
- 01Deploys to Cloudflare Workers to reduce server costs.
- 02Create multiple mailboxes under a single domain.
- 03Send mail with Resend, including bulk sending, inline images and attachments.
- 04Store and download attachments via Cloudflare R2.
- 05Forward received mail to a Telegram bot or another mailbox.
- 06Role-based admin controls for users, mail and resource limits.
Use cases
- Running a private or team mail service on a custom domain without a traditional server.
- Receiving verification codes and automatically extracting them with Workers AI.
- Batch-provisioning mailboxes for users through the open API.
- Forwarding mail from a custom domain to a Telegram bot for notifications.
Quick start
- 1
Follow the deployment guide linked in the README to deploy to Cloudflare Workers
Things to know
- Requires a Cloudflare account with Workers, D1, KV and R2 set up.
- Email sending relies on the Resend service, so you need a Resend account and API key.
- Self-hosting involves configuring several Cloudflare services.
Topics
FAQ
- What is cloud-mail?
- A self-hostable email service built on Cloudflare Workers, letting you create multiple mailboxes under one domain with sending, attachments and a responsive web UI. Cloud Mail is a lightweight email service that runs on Cloudflare Workers. With one domain you can create many separate mailboxes, similar to mainstream webmail platforms, without maintaining your own mail server.
- Is cloud-mail free to use? What license does it have?
- cloud-mail is open source under the MIT license. Check the license terms before using it in commercial products.
- Is cloud-mail still maintained?
- Actively maintained. The last commit to cloud-mail was on Oct 19, 2026.
- What can I use cloud-mail for?
- Running a private or team mail service on a custom domain without a traditional server. Receiving verification codes and automatically extracting them with Workers AI. Batch-provisioning mailboxes for users through the open API. Forwarding mail from a custom domain to a Telegram bot for notifications.
- How do I install cloud-mail?
- Follow the deployment guide linked in the README to deploy to Cloudflare Workers
- Where can I get cloud-mail?
- The source code and installation instructions are on GitHub: https://github.com/maillab/cloud-mail
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
A self-hosted, Cloudflare Workers-compatible platform packaged as a single Rust binary for running Workers, KV, D1, R2 and more on one machine.
Self-hosted mail server for your own domain, with SMTP/IMAP/POP3, CardDAV/CalDAV, a React webmail and admin console, deployed via Docker Compose.
A self-hosted, web-based take on the One Sec app: a ten-second breathing page before distracting apps open, plus a daily goals page, running on Cloudflare's free tier.
A bookmark manager built on Cloudflare Workers and D1 that saves links via a bookmarklet or Chrome extension, with no account required.
Self-hosted, open-source customer engagement platform for sending broadcasts and automated journeys across email, SMS, push, WhatsApp and Slack.