Comment mon application se connecte-t-elle à Mailpit ?

Définissez l'hôte SMTP de votre application sur 127.0.0.1 et le port sur 1025. Si votre application tourne sur le même VPS que Mailpit, elle atteint le serveur via l'interface loopback. Aucun identifiant, mot de passe ou TLS requis par défaut.

Pourquoi remplacer MailHog par Mailpit ?

MailHog n'est plus maintenu depuis 2020 et porte une faille XSS stockée non corrigée (Exploit-DB 50971). Mailpit est son successeur actif, installé par défaut dans Laravel Sail et DDEV, et ajoute la recherche plein texte, la notation anti-spam, les vérifications de compatibilité HTML et une API REST pour la CI.

Combien de messages Mailpit conserve-t-il ?

Par défaut jusqu'à 500 messages. Les plus anciens sont automatiquement supprimés lorsque la limite est atteinte. Ajustez-la avec la variable d'environnement MP_MAX_MESSAGES.

Peut-on utiliser Mailpit comme relais SMTP en production ?

Non. Mailpit est un outil de développement qui ignore délibérément tous les e-mails. Pour les e-mails transactionnels en production, utilisez un relais comme Postfix, Brevo ou Amazon SES. Mailpit est réservé aux environnements de développement et de staging.

Démarrer rapidement un projet logiciel.

Mailpit

Capturez et prévisualisez les e-mails de votre application sans les délivrer. Remplacez MailHog — open source, un seul conteneur Docker.

50 Mo minimum RAM 1 vCPU Disponible

Mailpit est un serveur SMTP de test pour développeurs qui intercepte chaque e-mail envoyé par votre application et l'affiche dans une interface web soignée plutôt que de le délivrer. Il remplace MailHog (abandonné avec une faille XSS non corrigée depuis 2020) avec la recherche plein texte, le support TLS, la notation anti-spam, les vérifications de compatibilité HTML et l'aperçu mobile, le tout dans un binaire Go de moins de 50 Mo de RAM. Déployez-le sur le même VPS que votre application web, pointez votre SMTP vers localhost:1025, et chaque e-mail atterrit en temps réel dans la boîte de réception Mailpit.

Fonctionnalités clés

Serveur SMTP sur le port 1025 — configurez votre application pour envoyer vers localhost:1025, aucun e-mail réel n'est délivré.

Interface web sur le port 8025 avec recherche plein texte sur l'objet, l'expéditeur, le destinataire et le corps.

API REST pour les pipelines CI — vérifiez le contenu des e-mails, le nombre de pièces jointes et les destinataires dans vos tests automatisés.

Notation anti-spam avec les règles SpamAssassin — détectez les problèmes de délivrabilité avant qu'ils n'atteignent la production.

Vérification de compatibilité HTML — repérez les propriétés CSS non prises en charge dans les principaux clients mail.

Aperçu mobile et vue de la source brute pour les parties HTML et texte brut.

Interface POP3 pour récupérer les e-mails capturés avec n'importe quel client mail.

Binaire Go unique, moins de 50 Mo de RAM, base de données SQLite sur un volume persistant.

Quand utiliser cette solution ?

1

Tester l'envoi d'e-mails pendant le développement

Faites tourner votre application web et Mailpit sur le même VPS. Configurez votre SMTP sur l'hôte localhost, port 1025. Chaque e-mail de réinitialisation de mot de passe, notification ou facture apparaît instantanément dans la boîte de réception Mailpit — sans risque d'envoi à de vrais utilisateurs.

2

Vérifier les e-mails dans les pipelines CI

Interrogez l'API REST depuis votre suite de tests pour vérifier que le bon e-mail a bien été envoyé, que l'objet correspond, que les pièces jointes sont présentes et que le bon destinataire a reçu le message — sans relais SMTP réel.

3

Détecter les problèmes de délivrabilité avant la production

Utilisez le rapport de notation anti-spam et de compatibilité HTML pour détecter les en-têtes manquants, le HTML cassé et les propriétés CSS qui seront supprimées par Gmail ou Outlook — avant qu'un e-mail ne touche une seule vraie boîte de réception.

Déployer Mailpit sur votre VPS

Guide optimisé pour les VPS Cloud ServOrbit.

01

Déployer Mailpit depuis la marketplace

Ouvrez votre panneau de contrôle ServOrbit, allez dans Marketplace → Développement → Mailpit, et cliquez sur Déployer. Docker tire l'image axllent/mailpit et démarre le serveur. L'interface web est prête en moins de 10 secondes.

02

Configurer le SMTP de votre application

Dans les variables d'environnement ou le fichier de configuration de votre application, définissez l'hôte SMTP sur 127.0.0.1 et le port sur 1025. Aucune authentification, aucun TLS requis. Si votre application tourne sur le même VPS, chaque e-mail envoyé sera intercepté par Mailpit.

03

Ouvrir l'interface web Mailpit

Accédez au domaine attaché à votre instance Mailpit. Vous verrez la liste des e-mails interceptés : cliquez sur n'importe quel message pour inspecter son rendu HTML, sa version texte brut, sa source brute, ses en-têtes et son score anti-spam.

04

Se connecter la première fois

Mailpit n'impose aucune authentification par défaut. L'interface est accessible directement après le déploiement. Si vous exposez Mailpit sur un domaine public, envisagez d'ajouter une authentification via les variables d'environnement MP_UI_AUTH_FILE ou de restreindre l'accès par IP.

05

Utiliser l'API REST dans vos tests

Appelez GET /api/v1/messages pour lister les e-mails interceptés. Filtrez par destinataire, objet ou date. Vérifiez le contenu exact envoyé par votre application — pas de mock, pas de stub, le vrai e-mail via le vrai SMTP.

06

Vérifier le rapport de compatibilité HTML

Ouvrez n'importe quel e-mail HTML et cliquez sur l'onglet Compatibilité. Mailpit met en évidence les propriétés CSS non prises en charge ou partiellement supportées dans Gmail, Outlook, Apple Mail et d'autres clients majeurs, afin que vous puissiez les corriger avant la mise en production.

Questions fréquentes

Non. Mailpit est un serveur piège : il accepte toutes les connexions SMTP sur le port 1025 et stocke chaque message dans sa base SQLite locale sans le transmettre nulle part. Aucun e-mail ne rejoint une vraie boîte de réception.

Intégrer le bouton de déploiement

Vous maintenez un projet qui utilise Mailpit ? Ce bouton permet à vos lecteurs de le déployer sur un VPS en un clic, sans lire de documentation Docker.

Markdown

[![Deploy Mailpit on ServOrbit](https://servorbit.com/brand/deploy/button.svg)](https://servorbit.com/vps-cloud?template=mailpit&utm_source=deploy-badge&utm_medium=referral&utm_campaign=mailpit)

HTML

<a href="https://servorbit.com/vps-cloud?template=mailpit&utm_source=deploy-badge&utm_medium=referral&utm_campaign=mailpit"><img src="https://servorbit.com/brand/deploy/button.svg" alt="Deploy Mailpit on ServOrbit" height="40"></a>

Le bouton pointe vers la commande d'un VPS avec le template présélectionné. L'image est servie depuis servorbit.com — rien à héberger de votre côté.