Configuration

By default, Mailpit listens on port 8025 for the web UI and port 1025 for SMTP.
Runtime options

Mailpit runtime flags & environment variables

Web UI & API server

Configuration options for the web UI & API, including HTTPS

SMTP server

Configuring SMTP (including STARTTLS or SSL/TLS)

POP3 server

Enable the POP3 server (with or without TLS)

SpamAssassin

Integrate Mailpit with SpamAssassin to test “spamminess” of messages

TLS certificates

Creating a self-signed HTTPS/TLS certificate for HTTP/API, SMTP, and POP3

Password files

Creating password files for HTTP/API, SMTP, and POP3

SMTP forwarding

Automatically auto-forward all messages to another email address

SMTP relaying

Configure message relaying (release) in Mailpit

Prometheus metrics

Monitor Mailpit performance and statistics with Prometheus

HTTP proxy

How to configure nginx, Apache, or IIS to proxy to Mailpit

Chaos

Use Mailpit’s Chaos feature to artificially trigger SMTP errors to test application resilience

Data compression

Tuning Mailpit’s compression levels, RAM & CPU usage

Email storage

Mailpit stores messages in either a permanent or temporary SQLite database

Troubleshooting

Common issues and limitations when running Mailpit

UI security policies

Various privacy & security policies enforced by Mailpit

Unix domain sockets

Configuring Mailpit to listen on Unix domain sockets instead of network interfaces

Edit this page