Guide de développement

MailHog, Mailpit et Papercut SMTP : comment tester les emails en local

Trois serveurs SMTP de test qui capturent les emails de votre application sans les envoyer à personne : ce que chacun propose, comment l'installer, sur quels ports il écoute et pourquoi MailHog n'est plus le choix recommandé.

Un serveur SMTP qui accepte tout et ne livre rien

Quand vous construisez une application qui envoie des emails (inscriptions, réinitialisations de mot de passe, commandes), vous devez voir ce qui part sans que cela n'atteigne personne. Un serveur SMTP de test accepte n'importe quel message, le stocke et vous le montre dans une interface, mais ne le livre jamais à un destinataire.

Vous vérifiez ainsi l'objet, le HTML, le texte, les en-têtes et les pièces jointes avec les données de votre environnement local, sans risque d'écrire à des clients et sans dépendre de la connexion ou des identifiants d'un fournisseur.

Réponse courte

Pour un nouveau projet, utilisez Mailpit : il fonctionne sur Windows, Linux, macOS et Docker, écoute sur les ports 1025 (SMTP) et 8025 (web) et est activement maintenu. MailHog utilise les mêmes ports, mais sa dernière version date d'août 2020 et il n'est plus maintenu. Papercut SMTP est l'alternative si vous travaillez sous Windows et préférez une application de bureau.

Comparaison

Les trois outils en un coup d'œil

OutilInstallationPorts par défautStatut
MailpitBinaire pour Windows, Linux et macOS, Homebrew ou l'image Docker axllent/mailpitSMTP 1025 · web 8025Maintenu : version 1.33.0, publiée le 31 octobre 2026
MailHogBinaire pour Windows, Linux et macOS, Homebrew ou l'image Docker mailhog/mailhogSMTP 1025 · web 8025Non maintenu : sa dernière version, 1.0.1, date du 11 août 2020
Papercut SMTPInstallateur Windows (x64, x86 et ARM64), winget ou l'image Docker changemakerstudiosus/papercut-smtpBureau : SMTP 25 · Docker : SMTP 2525 et web 8080Maintenu : version 7.8.0, publiée le 15 août 2026

Versions et dates vérifiées le 2 novembre 2026 sur les pages officielles de chaque projet.

Mailpit

Mailpit : le remplaçant habituel de MailHog

Mailpit s'est inspiré de MailHog et en est devenu le remplaçant habituel : il fait le même travail sur les mêmes ports par défaut et continue de publier de nouvelles versions. C'est un binaire unique sous licence MIT.

En plus d'afficher chaque email dans le navigateur, il inclut une API REST pour les tests automatisés, la recherche et les tags, une vérification de compatibilité HTML avec les clients de messagerie, un vérificateur de liens et d'images et des tests anti-spam avec SpamAssassin ou Rspamd.

  1. 1Téléchargez le binaire pour votre système depuis la page officielle des versions, installez-le avec brew install mailpit sous macOS ou démarrez l'image Docker.
  2. 2Lancez mailpit. Par défaut, il écoute le SMTP sur le port 1025 et sert l'interface web sur le 8025.
  3. 3Pointez votre application vers l'hôte localhost, port 1025, sans chiffrement ni authentification.
  4. 4Ouvrez http://localhost:8025 et envoyez un email de test depuis votre application.
docker run -d --restart unless-stopped --name=mailpit -p 8025:8025 -p 1025:1025 axllent/mailpit
MailHog

MailHog : pourquoi ce n'est plus un bon point de départ

Pendant des années, MailHog a été l'outil de référence pour capturer les emails en développement, et beaucoup de tutoriels et d'anciennes configurations Docker l'utilisent encore.

Sa dernière version, 1.0.1, est sortie le 11 août 2020. Le README de Mailpit indique lui-même que MailHog n'est plus maintenu et n'a connu ni développement actif ni mises à jour de sécurité depuis des années.

Si vous l'utilisez déjà, passer à Mailpit est simple : il écoute sur les mêmes ports (1025 pour le SMTP et 8025 pour le web), votre application n'a donc besoin d'aucun changement ; remplacez simplement le binaire ou l'image Docker.

Papercut SMTP

Papercut SMTP : l'option de bureau pour Windows

Papercut SMTP est une application de bureau Windows qui se loge dans la barre des tâches et vous notifie à l'arrivée d'un email. Elle affiche le HTML, le texte, les en-têtes, les parties MIME, les pièces jointes et la source brute de chaque message.

Elle inclut un service en arrière-plan facultatif avec une interface web qui reçoit les emails même quand l'application est fermée, et une image Docker pour les conteneurs et la CI. L'application de bureau écoute sur 127.0.0.1, port 25, sans identifiants ; l'image Docker utilise le port 2525 pour le SMTP et le 8080 pour le web.

winget install ChangemakerStudios.Papercut-SMTP

La documentation de Papercut avertit que le paquet winget peut être en retard sur la dernière version publiée sur GitHub.

Configuration

Comment pointer votre application vers le SMTP local

La configuration est la même avec les trois outils : l'hôte est localhost (ou le nom du service si votre application tourne dans Docker Compose), le port est celui sur lequel l'outil écoute et aucun chiffrement ni nom d'utilisateur n'est nécessaire. L'expéditeur peut être n'importe quelle adresse.

# 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});

Gardez cette configuration uniquement dans votre environnement local. En staging et en production, la même application doit utiliser un vrai serveur SMTP avec ses propres identifiants.

Production

Des tests locaux à l'envoi réel

Ces outils ne livrent pas d'emails, ils ne peuvent donc pas vous dire si vos messages atteindront la boîte de réception. Pour cela, vous devez envoyer avec votre domaine authentifié (SPF et DKIM) depuis un serveur avec une bonne réputation et voir le statut réel de chaque email.

L'approche la plus pratique est de garder la même forme de configuration dans chaque environnement et de ne changer que l'hôte, le port et les identifiants : localhost:1025 en développement et le SMTP de votre fournisseur en staging et en production.

  • Utilisez des identifiants différents dans chaque environnement et gardez-les hors du dépôt.
  • Vérifiez votre domaine auprès du fournisseur avant le premier envoi réel.
  • Testez les flux complets (inscription, mot de passe, commande) en staging avec les adresses de votre équipe.
  • Vérifiez dans le journal du fournisseur que les emails sont livrés et comment les bounces sont gérés.
FAQ

Questions fréquentes

MailHog fonctionne-t-il encore ?

Il démarre encore, mais sa dernière version date d'août 2020 et il ne reçoit aucune mise à jour de sécurité. Pour un nouveau projet, Mailpit couvre le même périmètre sur les mêmes ports par défaut.

Mailpit ou Papercut SMTP ?

Mailpit fonctionne sur Windows, Linux, macOS et Docker, s'utilise depuis le navigateur et dispose d'une API pour les tests automatisés. Papercut est plus pratique si vous travaillez sous Windows et voulez une application de bureau qui vous notifie à chaque email.

Ces outils livrent-ils l'email au destinataire ?

Non. Ils le capturent et l'affichent, mais ne le livrent jamais. Mailpit et Papercut peuvent être configurés pour relayer vers un serveur SMTP externe, mais par défaut aucun message ne quitte votre machine.

Quel port dois-je indiquer dans mon application ?

1025 avec Mailpit ou MailHog. Avec Papercut, 25 pour l'application de bureau ou 2525 si vous utilisez son image Docker. Dans tous les cas, sans chiffrement ni authentification.

Mailiqo

Quand vous passez en production

Mailiqo envoie les emails de votre application avec votre domaine authentifié, en SMTP ou par API, et journalise le statut de chaque email dans le tableau de bord. Commencez gratuitement, sans carte bancaire.

Créer un compte gratuit
Mailiqo Labs

Mettez le guide en pratique

Les outils vous permettent de vérifier SPF, DMARC, en-têtes, bounces et HTML avec vos propres données, sans inscription.