Is mailflare still maintained?

Yes, active. Last change yesterday.

Can I trust mailflare?

Some track record. 5.9k stars, 6 months old. Get it from the official repo and read what it installs.

gitmanual

Reading the repo

Opening the box…

How to set up mailflare (hieunc229/mailflare) · gitmanual

Assembly instructions

hieunc229/mailflare

Email for professionals and teams

Node.jsNext.js#cloudflare#cloudflare-workers#email

Difficulty: Moderate
Time: about 15 min
Stars: ★ 5,889
Activity: Updated this month

Before you start

Is it free?: YesOpen source (AGPL-3.0).
Still maintained?: Yes, activeLast change yesterday.
Can I trust it?: Some track record5.9k stars, 6 months old. Get it from the official repo and read what it installs.

Saved setup from 12 h ago

Will it work on macOS?

Yes, with Docker on macOS

It's a self-hosted app: the README runs it with Docker, and you open it in your browser.
On macOS that means installing Docker Desktop first.

Your system

macOS Windows Linux

Start here

Website ↗mailflare.coThe project's own site.

Heads-upBuilding it yourself? It also needs PostgreSQL and MySQL.

Run it with Docker

A self-hosted app: Docker runs it on your computer and you open it in the browser. Needs Docker Desktop (or Docker Engine on Linux). Run docker compose commands inside the cloned repo folder.

Docker

docker compose up -d --build

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for macOS yet.

Still stuck? Ask an AI

Opens a chat with this manual already filled in, for macOS. It uses your own account; gitmanual sends nothing.

Ask Claude Ask ChatGPT

Parts list

1×Node.js LTS (no version pinned)runtime
1×npm package manager
1×PostgreSQL service
1×MySQL service

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/hieunc229/mailflare/badge.svg)](https://gitmanual.com/hieunc229/mailflare)

Good to know

Dockerfile available (base image: node:22-bookworm-slim).
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: deploy/cloudflare-email-relay/package.json

Details

License: AGPL-3.0
Open issues: 30
Branch: main

package.json scripts (26)

devnpm run db:bundle && vp dev --port 3000
buildnpm run db:bundle && vp build
build:nextnpm run db:bundle && MAILFLARE_RUNTIME=node next build
startvp preview --port 3000
lintvp lint .
deploynpm run build && npm run deploy:worker
deploy:workerwrangler deploy
deploy:localnpm run deploy
uploadnpm run build && wrangler versions upload
previewnpm run build && vp preview --port 3000
cf-typegenwrangler types --env-interface CloudflareEnv ./cloudflare-env.d.ts
push:keysnode scripts/generate-vapid-keys.mjs
db:bundlenode scripts/generate-migration-bundle.mjs
db:generatedrizzle-kit generate
db:generate:pgMAILFLARE_DB_DIALECT=postgres drizzle-kit generate --config=drizzle.config.pg.ts
db:generate:mysqlMAILFLARE_DB_DIALECT=mysql drizzle-kit generate --config=drizzle.config.mysql.ts
db:smokenode scripts/run-ts.mjs scripts/db-smoke.ts
auth:recovery-linknode scripts/run-ts.mjs scripts/passkey-recovery-link.ts
db:migrate:localwrangler d1 migrations apply DB --local
db:migrate:remotewrangler d1 migrations apply DB --remote
migratewrangler d1 migrations apply DB
db:seedcurl -X POST http://localhost:3000/api/seed
build:nodenpm run db:bundle && MAILFLARE_RUNTIME=node next build && node scripts/build-server.mjs
start:nodeMAILFLARE_RUNTIME=node NODE_ENV=production node dist/server.mjs
dev:nodenpm run db:bundle && node scripts/build-server.mjs && MAILFLARE_RUNTIME=node node dist/server.mjs

Files we read (6)

.env.docker.example

.github/workflows/deploy-update.yml

Dockerfile

README.md

docker-compose.yml

package.json

1,628 files in the repo