MailFlow is a self-hosted, open-source webmail client. Connect Gmail, iCloud, Outlook, and any IMAP server — then read everything in one fast, clean interface that runs entirely on your own server.
Works with your favourite email providers
Built for people who want full control over their email without sacrificing experience.
Every account in a single, chronological feed. Stop switching tabs and start reading.
Gmail, iCloud, Outlook, Fastmail, or your own mail server. If it speaks IMAP, it works.
TOTP 2FA with Google Authenticator, Authy, or any compatible app. Your accounts stay yours.
Your email stays on your server. No third-party clouds, no data harvesting, no subscriptions.
Dark mode, light mode, multiple color schemes, typography controls, and flexible layouts.
Instant search across every connected account simultaneously, powered by PostgreSQL.
New mail appears the instant it arrives via WebSocket. No polling, no manual refresh.
Docker Compose gets you from zero to a running inbox in under five minutes.
No complex configuration. No ops expertise required.
Grab the repo and fill in two secrets — a session key and a database password. Everything else has sensible defaults.
# Clone the repository
git clone https://github.com/maathimself/mailflow
cd mailflow
# Create your config file
cp .env.example .envOne command starts everything — the app, database, Redis, and a reverse proxy that handles HTTPS automatically.
# Build and start all services
docker compose up -d --build
# First build takes ~3 minutes
# Caddy handles TLS automaticallyRegister the first user — they become admin automatically. Then connect your email accounts from the settings panel.
# Supported providers
Gmail → App Password
iCloud Mail → App-Specific Password
Outlook → OAuth2 / App Password
Custom IMAP → Any serverYour email contains your most sensitive communications. MailFlow was built with security in mind from day one — because when your inbox lives on your server, you deserve to know exactly how it's protected.
And because MailFlow is open source, you don't have to take our word for it. Read the code. Audit it yourself.
Read the source →A server with Docker installed is all you need. Caddy handles TLS certificates from Let's Encrypt automatically — no manual cert setup.
# 1. Get the code
git clone https://github.com/maathimself/mailflow
cd mailflow
# 2. Configure — only two values required:
# SESSION_SECRET → openssl rand -hex 32
# DB_PASSWORD → openssl rand -hex 16
cp .env.example .env
# 3. Launch (first build ~3 min, then instant)
docker compose up -d --buildThen open your server's address in a browser. The first account registered becomes admin.