Entwickler-Leitfaden

MailHog, Mailpit und Papercut SMTP: E-Mails lokal testen

Drei Test-SMTP-Server, die die E-Mails deiner Anwendung abfangen, ohne sie an jemanden zu senden: was jeder bietet, wie du ihn installierst, auf welchen Ports er lauscht und warum MailHog nicht mehr die empfohlene Wahl ist.

Ein SMTP-Server, der alles annimmt und nichts zustellt

Wenn du eine Anwendung baust, die E-Mails sendet (Registrierungen, Passwort-Resets, Bestellungen), musst du sehen, was rausgeht, ohne dass es jemanden erreicht. Ein Test-SMTP-Server nimmt jede Nachricht an, speichert sie und zeigt sie dir in einer Oberfläche, stellt sie aber nie an einen Empfänger zu.

So prüfst du Betreff, HTML, Text, Header und Anhänge mit den Daten deiner lokalen Umgebung, ohne das Risiko, Kunden anzuschreiben, und ohne von der Verbindung oder den Zugangsdaten eines Anbieters abzuhängen.

Kurze Antwort

Für ein neues Projekt nimm Mailpit: Es läuft unter Windows, Linux, macOS und Docker, lauscht auf Port 1025 (SMTP) und 8025 (Web) und wird aktiv gepflegt. MailHog nutzt dieselben Ports, aber seine letzte Version stammt vom August 2020 und es wird nicht mehr gepflegt. Papercut SMTP ist die Alternative, wenn du unter Windows arbeitest und eine Desktop-App bevorzugst.

Vergleich

Die drei Tools auf einen Blick

ToolInstallationStandardportsStatus
MailpitBinary für Windows, Linux und macOS, Homebrew oder das Docker-Image axllent/mailpitSMTP 1025 · Web 8025Gepflegt: Version 1.33.0, veröffentlicht am 31. Oktober 2026
MailHogBinary für Windows, Linux und macOS, Homebrew oder das Docker-Image mailhog/mailhogSMTP 1025 · Web 8025Nicht gepflegt: die letzte Version, 1.0.1, stammt vom 11. August 2020
Papercut SMTPWindows-Installer (x64, x86 und ARM64), winget oder das Docker-Image changemakerstudiosus/papercut-smtpDesktop: SMTP 25 · Docker: SMTP 2525 und Web 8080Gepflegt: Version 7.8.0, veröffentlicht am 15. August 2026

Versionen und Daten am 2. November 2026 auf den offiziellen Seiten jedes Projekts geprüft.

Mailpit

Mailpit: der übliche Ersatz für MailHog

Mailpit wurde von MailHog inspiriert und ist zu seinem üblichen Ersatz geworden: Es erledigt dieselbe Aufgabe auf denselben Standardports und veröffentlicht weiterhin neue Versionen. Es ist ein einzelnes Binary unter MIT-Lizenz.

Neben der Anzeige jeder E-Mail im Browser bietet es eine REST-API für automatisierte Tests, Suche und Tags, eine HTML-Kompatibilitätsprüfung gegen E-Mail-Clients, eine Link- und Bildprüfung sowie Spamtests mit SpamAssassin oder Rspamd.

  1. 1Lade das Binary für dein System von der offiziellen Release-Seite herunter, installiere es unter macOS mit brew install mailpit oder starte das Docker-Image.
  2. 2Führe mailpit aus. Standardmäßig lauscht es auf Port 1025 für SMTP und liefert die Weboberfläche auf 8025.
  3. 3Richte deine Anwendung auf Host localhost, Port 1025, ohne Verschlüsselung oder Authentifizierung.
  4. 4Öffne http://localhost:8025 und sende eine Test-E-Mail aus deiner Anwendung.
docker run -d --restart unless-stopped --name=mailpit -p 8025:8025 -p 1025:1025 axllent/mailpit
MailHog

MailHog: warum es kein guter Startpunkt mehr ist

Jahrelang war MailHog das Standardwerkzeug, um E-Mails in der Entwicklung abzufangen, und viele Tutorials und ältere Docker-Setups verwenden es noch.

Seine letzte Version, 1.0.1, erschien am 11. August 2020. Die README von Mailpit sagt, dass MailHog nicht mehr gepflegt wird und seit Jahren ohne aktive Entwicklung oder Sicherheitsupdates ist.

Wenn du es bereits nutzt, ist der Wechsel zu Mailpit einfach: Es lauscht auf denselben Ports (1025 für SMTP und 8025 für das Web), deine Anwendung braucht also keine Änderungen; tausche nur das Binary oder das Docker-Image.

Papercut SMTP

Papercut SMTP: die Desktop-Option für Windows

Papercut SMTP ist eine Windows-Desktop-App, die im Infobereich sitzt und dich benachrichtigt, wenn eine E-Mail eintrifft. Sie zeigt HTML, Text, Header, MIME-Teile, Anhänge und den Rohquelltext jeder Nachricht.

Sie enthält einen optionalen Hintergrunddienst mit Weboberfläche, der E-Mails auch bei geschlossener App empfängt, und ein Docker-Image für Container und CI. Die Desktop-App lauscht auf 127.0.0.1, Port 25, ohne Zugangsdaten; das Docker-Image nutzt Port 2525 für SMTP und 8080 für das Web.

winget install ChangemakerStudios.Papercut-SMTP

Die Dokumentation von Papercut warnt, dass das winget-Paket hinter der neuesten Version auf GitHub zurückliegen kann.

Einrichtung

Wie du deine Anwendung auf den lokalen SMTP richtest

Die Einrichtung ist bei allen drei Tools gleich: Der Host ist localhost (oder der Dienstname, wenn deine Anwendung in Docker Compose läuft), der Port ist der, auf dem das Tool lauscht, und es braucht weder Verschlüsselung noch Benutzernamen. Der Absender kann eine beliebige Adresse sein.

# Symfony (.env.local)
MAILER_DSN=smtp://localhost:1025

# Laravel (.env)
MAIL_MAILER=smtp
MAIL_HOST=127.0.0.1
MAIL_PORT=1025

# Node.js (Nodemailer)
nodemailer.createTransport({host: 'localhost', port: 1025, secure: false});

Behalte diese Konfiguration nur in deiner lokalen Umgebung. In Staging und Produktion sollte dieselbe Anwendung einen echten SMTP-Server mit eigenen Zugangsdaten verwenden.

Produktion

Vom lokalen Test zum echten Versand

Diese Tools stellen keine E-Mails zu, daher können sie dir nicht sagen, ob deine Nachrichten den Posteingang erreichen. Dafür musst du mit deiner authentifizierten Domain (SPF und DKIM) von einem Server mit guter Reputation senden und den echten Status jeder E-Mail sehen.

Am praktischsten ist es, in jeder Umgebung dieselbe Konfigurationsform zu behalten und nur Host, Port und Zugangsdaten zu ändern: localhost:1025 in der Entwicklung und den SMTP deines Anbieters in Staging und Produktion.

  • Verwende in jeder Umgebung andere Zugangsdaten und halte sie aus dem Repository heraus.
  • Verifiziere deine Domain beim Anbieter vor dem ersten echten Versand.
  • Teste die vollständigen Abläufe (Registrierung, Passwort, Bestellung) in Staging mit den Adressen deines Teams.
  • Prüfe im Protokoll des Anbieters, dass E-Mails zugestellt werden und wie Bounces behandelt werden.
FAQ

Häufig gestellte Fragen

Funktioniert MailHog noch?

Es startet noch, aber seine letzte Version stammt vom August 2020 und es erhält keine Sicherheitsupdates. Für ein neues Projekt deckt Mailpit dasselbe auf denselben Standardports ab.

Mailpit oder Papercut SMTP?

Mailpit läuft unter Windows, Linux, macOS und Docker, wird im Browser bedient und hat eine API für automatisierte Tests. Papercut ist praktischer, wenn du unter Windows arbeitest und eine Desktop-App willst, die dich über jede E-Mail benachrichtigt.

Stellen diese Tools die E-Mail an den Empfänger zu?

Nein. Sie fangen sie ab und zeigen sie an, stellen sie aber nie zu. Mailpit und Papercut lassen sich so einrichten, dass sie an einen externen SMTP-Server weiterleiten, aber standardmäßig verlässt keine Nachricht deinen Rechner.

Welchen Port stelle ich in meiner Anwendung ein?

1025 bei Mailpit oder MailHog. Bei Papercut 25 für die Desktop-App oder 2525, wenn du sein Docker-Image nutzt. In jedem Fall ohne Verschlüsselung oder Authentifizierung.

Mailiqo

Wenn du in Produktion gehst

Mailiqo sendet die E-Mails deiner Anwendung mit deiner authentifizierten Domain, über SMTP oder API, und protokolliert den Status jeder E-Mail im Dashboard. Kostenlos starten, keine Karte nötig.

Kostenloses Konto erstellen
Mailiqo Labs

Setze den Leitfaden in die Praxis um

Mit den Tools prüfst du SPF, DMARC, Header, Bounces und HTML mit deinen eigenen Daten, ohne Registrierung.