Softwaiz/gentlemail
Softwaiz/gentlemail has 18 GitHub stars and 2 forks. GitHot measured +5 stars in 24 hours. Last checked 2026-11-18 17:53 UTC. Last push 2026-11-18.
Measured star growth
- in 24h
- +5
- in 7 days
- Collecting history
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Open-source multi-domain webmail, email API and webhooks on your own Cloudflare account. Unlimited mailboxes for $5/month.
Self-hostedREADME.md
Original
GentleMail
Open-source, multi-domain webmail, email API and webhooks that run entirely on your own Cloudflare account. One deployment serves any number of domains, mailboxes and people for the $5/month Workers Paid plan: no per-seat pricing, no API keys handed to a third party.
Website: https://gentlemail.dev · Deploy guide: https://gentlemail.dev/docs/deploy/ · Docs: https://gentlemail.dev/docs · Changelog
- Inbox and outbox: a real webmail for people (conversations, search, attachments, spam folder, blocking) and a REST API for code.
- Many domains, one deployment: add domains and mailboxes in Admin, and choose which people can open which mailboxes.
- Webhooks: signed
message.receivedandmessage.sentevents with retries, to automate invoices, support alerts and more. - Your infrastructure: mail is stored in your own D1 database and R2 bucket, and sent with Cloudflare Email Service.

![]() |
![]() |
![]() |
| API keys and webhooks | On a phone |
Deploy your own
- Deploy. Click Deploy to Cloudflare above. Cloudflare copies the app into a new repository on your GitHub account, creates the database and storage, asks for a one-time
SETUP_TOKEN, then builds and deploys. Using a fork or clone of this whole repository with Workers Builds instead? Set Root directory toapps/mail. - Claim it. Open
/setupon your new Worker and create the admin account. - Connect a domain. Add it in Admin → Domains and run the three commands it shows.
- Create mailboxes and users, then send yourself a test message.
You need a Cloudflare account on Workers Paid and a domain whose DNS is on Cloudflare. The full guide (every step, configuration, an end-to-end test, updating and troubleshooting) is in apps/mail/README.md.
No Cloudflare API token
GentleMail never asks for a Cloudflare API token or account ID: it reaches D1, R2 and Email Service through Worker bindings. More on why.
Repository
A small pnpm workspace monorepo with one app today.
.
├── apps/
│ ├── mail/ the app: webmail, REST API and webhooks (one Cloudflare Worker)
│ └── docs/ the documentation site, served at gentlemail.dev/docs (Astro Starlight)
├── packages/
│ └── sdk/ the JavaScript SDK, published to npm as `gentlemail`
├── package.json workspace scripts
├── pnpm-lock.yaml
└── pnpm-workspace.yaml
apps/mail is the folder the Deploy button copies and the Root directory for Workers Builds. It has its own package.json, wrangler.jsonc and migrations. Its README has the tech stack (Workers, RedwoodSDK, D1 with plain SQL and no ORM, R2, Email Service), database and migration commands, a file-by-file layout and every script.
Commands
From the repository root:
pnpm install
pnpm dev:mail # local dev server, http://localhost:5173
pnpm --filter @emails/mail db:migrate:local # apply migrations to the local database
pnpm types # type-check
The lockfile is the workspace's pnpm-lock.yaml, so pnpm is the tool for this repository. Inside apps/mail, the everyday scripts (dev, build, deploy, db:migrate:*) also run with npm; check and release call pnpm.
Fork it
Missing something your product needs, like a mailboxes API, forwarding, or delivery to Telegram? Fork it and add it: mail comes in through apps/mail/src/lib/inbound.ts and goes out through apps/mail/src/lib/outbound.ts. Issues, discussions and pull requests are welcome.
Star History
License
MIT © Softwaiz


