English | 简体ä¸æ–‡
A personal, self-hosted mail workspace on Cloudflare Workers. Manage multiple domains and mail addresses from one responsive inbox, with an English and Simplified Chinese interface.
- Receive and send mail — Cloudflare Email Routing for inbound mail, Resend for outbound mail, attachments, and delivery tracking.
- Manage mail identities — sync existing Cloudflare routing configuration, manage domains and addresses, and choose sender identities and signatures.
- Organize your inbox — categories, labels, stars, archive, trash, advanced search, bulk actions, and navigation counts for unread mail, drafts, and sending or failed mail.
- Read and compose anywhere — desktop and mobile layouts, an optional reading pane, focused reading, replies, forwarding, and autosaved drafts.
- Keep control of access and data — local username/password or Cloudflare Access authentication, D1 for structured data, and R2 for raw mail and attachments.
- Stay notified — optional Telegram notifications with privacy settings and delivery retries.
For self-hosting, follow the deployment guide. You will need a Cloudflare account, a domain configured for Email Routing, and Resend for outbound mail.
For local development, use the development guide. Use the newest stable Bun already installed locally (minimum 1.4.0). Tests and deployments run locally; GitHub scans dependencies when a Release is published or the workflow is run manually, using the Bun version in package.json. A local demo mail provider is included.
Mail addresses are managed resources under one workspace Owner; login credentials and profile email are configured separately.
Develop each task in a dedicated worktree and new branch. Feature changes pass
local checks and remote PRE acceptance before a PR to main; merge and
production deployment follow explicit authorization. All PRs wait for Codex
bot review of the current head and handling of findings. Authorized PRs use rebase
merge by default, followed by main synchronization and completed task
worktree/branch cleanup. See the
development workflow.
| Guide | What it covers |
|---|---|
| User guide | Everyday mail, identities, search, and settings |
| Local development | Setup, administrator bootstrap, and verification |
| Deployment | First deployment, upgrades, and rollback |
| Maintenance and recovery | Backups, search indexes, cleanup, and recovery |
| Inbound reliability | Ingest conflicts, plus aliases, routing scope, and delivery evidence |
| Telegram | Bot setup and notification operations |
| All documentation | API, architecture, previews, design, and release records |
FlareMail is licensed under the GNU Affero General Public License,
version 3 or (at your option) any later version (AGPL-3.0-or-later).