# Deploy MailFlow with Easypanel

URL: /templates/mailflow

MailFlow is a self-hosted, unified webmail client that connects to your existing IMAP/SMTP accounts and brings them together into one clean, fast inbox — with theming, unified search, and a modern compose experience.

## Installation notes

Open your domain and create your account on first visit, then connect your existing email accounts (IMAP/SMTP) from Settings. Push notifications are optional — leave the VAPID keys blank to skip them, or generate a pair with `npx web-push generate-vapid-keys` and paste them in if you want desktop/mobile push support.

## Benefits

### Unified Inbox

Bring multiple existing IMAP/SMTP accounts together into one fast, clean inbox.

### You Control Your Mail

MailFlow connects to your own mail accounts — it doesn't host mail itself, so you keep using your existing provider.

### Modern UI

A polished, themeable interface with unified search and a smooth compose/reply flow.

## Features

### Multiple Themes

Light, dark, and accent theme options including Catppuccin and Gruvbox.

### Web Push Notifications

Optional VAPID-based push notifications for new mail, even with the tab closed.

### Fast Search

Search across all connected inboxes at once.

## Configuration

- `appServiceName` (App Service Name, required): mailflow

- `appServiceImage` (Frontend Service Image, required): ghcr.io/maathimself/mailflow-frontend:4.0.3

- `backendServiceImage` (Backend Service Image, required): ghcr.io/maathimself/mailflow-backend:4.0.3

- `vapidPublicKey` (VAPID Public Key): Set during installation — Optional. Enables web push notifications.

- `vapidPrivateKey` (VAPID Private Key): Set during installation

- `vapidSubject` (VAPID Subject): Set during installation — A mailto: address or URL identifying you to push services.

## Services

- mailflow-backend: app (ghcr.io/maathimself/mailflow-backend:4.0.3)

- mailflow: app (ghcr.io/maathimself/mailflow-frontend:4.0.3)

- mailflow-db: postgres

- mailflow-redis: redis

## Resources

- [GitHub](https://github.com/maathimself/mailflow)

- [Documentation](https://github.com/maathimself/mailflow#readme)

- [Template source](https://github.com/easypanel-io/templates/tree/main/templates/mailflow)