hieunc229/mailflare

▲ 254 stars today★ 6,752⑂ 1,156

Email for professionals and teams

About hieunc229/mailflare

hieunc229/mailflare is an open-source project on GitHub, mainly written in TypeScript. Email for professionals and teams It currently holds 6,752 stars and 1,156 forks with 37 open issues, and was last pushed on 2026-11-16 (repository created 2026-05-26).

Project Overview

Git Homed tracks it on the Today's Trending board, currently at rank #36 with 254 new stars today.

GitHub Repository Details

Repository hieunc229/mailflare · default branch main · size 78637 KB · watchers 11 · source: GitHub REST API and repository README

README

https://github.com/hieunc229/mailflare/blob/HEAD/Mailflare

Mailflare

A self-hosted alternative to Google Workspace. Setup custom domain Emails, Calendar, Drive, Booking and built-in AI agents.

Run it on Cloudflare or Docker. Send and receive with Cloudflare, Resend or Amazon SES. Store files in R2, Backblaze B2 or AWS S3. Use D1, Postgres, MySQL or Turso for the database.

Deploy to Cloudflare

Screenshots

https://github.com/hieunc229/mailflare/blob/HEAD/Inbox
Inbox
https://github.com/hieunc229/mailflare/blob/HEAD/Manage domains
Domains
https://github.com/hieunc229/mailflare/blob/HEAD/Manage inboxes
Mailboxes
https://github.com/hieunc229/mailflare/blob/HEAD/Calendar
Calendar
https://github.com/hieunc229/mailflare/blob/HEAD/Booking
Booking
https://github.com/hieunc229/mailflare/blob/HEAD/Drive
Drive

Sponsors

https://github.com/hieunc229/mailflare/blob/HEAD/Sequenzy   https://github.com/hieunc229/mailflare/blob/HEAD/Drivemug

Want to support Mailflare? Become a sponsor.

Features

Apps

Technical

Mailflare currently supports 34 languages, including English, Português (Brasil), Português (Portugal), Español, Français, Deutsch, Italiano, Nederlands, Polski, Українська, Русский, Türkçe, 中文(简体), 日本語, 한국어, Bahasa Indonesia, Bahasa Melayu, Tiếng Việt, ไทย, हिन्दी, বাংলা, मराठी, తెలుగు, தமிழ், ગુજરાતી, ಕನ್ನಡ, മലയാളം, ਪੰਜਾਬੀ, සිංහල, Kiswahili, Hausa, plus العربية, اردو and فارسی (right-to-left).

Cost

You can receive and send mail for free.

New Amazon SES accounts start in a sandbox. Ask AWS for production access to lift it. Prices change, so check Resend, Amazon SES and Cloudflare.

Deploy

1. Deploy the app. Click Deploy to Cloudflare. Keep the app name mailflare, or it will break. 2. Finish setup. Open the app at /setup and create your admin account. 3. Connect a domain. Add a domain from the same Cloudflare account, then create your first mailbox.

CF_TOKEN is required. Create a scoped Cloudflare API token with these permissions:
> - All accounts: Email Sending:Edit, DNS Settings:Edit, Email Routing Addresses:Edit
- All zones: DNS Settings:Edit, Email Routing Rules:Edit, Zone Settings:Edit, DNS:Edit

More options: deployment guide.

Deploy with an AI agent

Paste this into an AI agent that has terminal access (Claude Code, Codex, Cursor and similar):

Install Mailflare for me from https://github.com/hieunc229/mailflare on my Cloudflare account.

1. Read README.md, docs/deployment.md and wrangler.jsonc first. 2. Ask me for my Cloudflare account ID and two API tokens, using a secret input: a deploy token (for Wrangler) and a runtime token (the Worker secret CF_TOKEN). Never print them, commit them, or pass them as command arguments. 3. Keep the Worker name exactly "mailflare". Create or reuse the D1 database "mailflare", the R2 bucket "mailflare-raw", and the queues "mailflare-inbound", "mailflare-outbound" and "mailflare-agent". 4. Install dependencies, run npm run deploy, and set CF_TOKEN as a Worker secret. Do not run remote database migrations yourself. The /setup page does that. 5. Give me the app URL and anything I still need to do. I will open /setup, create the admin account and connect my domain.

Token permissions and more options: deployment guide.

Self-host with Docker

Runs as one container on any server, with SQLite and local files.

cp .env.docker.example .env.docker
docker compose up -d --build

See self-hosting.

Local development

cp .dev.vars.example .dev.vars
npm install
npm run db:migrate:local
npm run dev

Add your Cloudflare credentials to .dev.vars, then open localhost:3000. Run npm run db:seed to load sample data.

A schema change needs a migration for each database type. See Databases.

Documentation

License

See LICENSE.

GitHub Stars & Activity

6,752Stars
1,156Forks
37Open issues
TypeScriptLanguage

GitHub Popularity

GitHub stars6,752
Forks1,156
Open issues37
Primary languageTypeScript
LicenseAGPL-3.0
Stars gained today254
Created2026-05-26
Last pushed2026-11-16

Trending History

Daily boardrank #36 · ▲ 254 stars

Related GitHub Projects

1

stablyai / orca

TypeScript★ 127,260⑂ 8,075▲ 1,052 stars
→
2

ChromeDevTools / chrome-devtools-mcp

TypeScript★ 57,914⑂ 4,863▲ 841 stars
→
3

tashfeenahmed / freellmapi

TypeScript★ 53,735⑂ 7,551▲ 649 stars
→
4

dream-num / univer

TypeScript★ 28,626⑂ 2,606▲ 1,828 stars
→
5

milind-soni / OpenMausBot

TypeScript★ 24,497⑂ 3,418▲ 662 stars
→
6

ag-ui-protocol / ag-ui

TypeScript★ 19,726⑂ 2,037▲ 791 stars
→
7

cursor / plugins

TypeScript★ 16,722⑂ 1,787▲ 196 stars
→
8

backnotprop / plannotator

TypeScript★ 12,862⑂ 1,287▲ 696 stars
→

More Trending Repositories