Mailpit: servidor SMTP de prueba autoalojado en tu VPS

Por qué reemplazar MailHog por Mailpit

Lo que Mailpit aporta en la práctica

• Interfaz moderna con búsqueda de texto completo, visualización HTML/texto, previsualización móvil e inspección de cabeceras
• Binario único de Go compilado estáticamente — sin dependencias del sistema, funciona en un contenedor de 20 MB
• Consumo de memoria inferior a 50 MB en reposo, estable incluso con miles de mensajes en sesión
• API REST retrocompatible con MailHog (/api/v1/messages, /api/v1/search) para scripts existentes
• Soporte SMTP autenticado, TLS opcional y control de acceso por red
• Webhook configurable para notificar a un endpoint externo en cada recepción de correo

Prerrequisitos

Desplegar Mailpit en 5 pasos

1. 01

   Crear el directorio y el archivo Compose

   mkdir -p /opt/mailpit && cd /opt/mailpit

   Crea el siguiente archivo docker-compose.yml:

   services:
     mailpit:
       image: axllent/mailpit:latest
       container_name: mailpit
       restart: unless-stopped
       ports:
         - "127.0.0.1:1025:1025"
         - "127.0.0.1:8025:8025"
       environment:
         MP_MAX_MESSAGES: 500
         MP_SMTP_AUTH_ACCEPT_ANY: "true"
         MP_SMTP_AUTH_ALLOW_INSECURE: "true"
         MP_UI_AUTH: "admin:changeme"
       volumes:
         - mailpit_data:/data
   volumes:
     mailpit_data:

   Los puertos están vinculados a 127.0.0.1 únicamente: Mailpit nunca se expone directamente en la IP pública. La variable MP_UI_AUTH activa la autenticación HTTP básica en la interfaz web — cambia la contraseña. MP_MAX_MESSAGES limita el número de correos conservados en memoria por sesión.

2. 02

   Iniciar el contenedor

   docker compose up -d
   docker compose logs -f mailpit

   La línea starting on [::]:1025 confirma que el servidor SMTP está escuchando. Verifica que los puertos estén correctamente vinculados a localhost:

   ss -tlnp | grep -E '1025|8025'

   Esperado: 127.0.0.1:1025 y 127.0.0.1:8025 únicamente — nunca 0.0.0.0.

3. 03

   Configurar el proxy inverso Nginx

   Crea /etc/nginx/sites-available/mailpit:

   server {
       listen 443 ssl;
       server_name mail.your-domain.com;
   
       ssl_certificate     /etc/letsencrypt/live/mail.your-domain.com/fullchain.pem;
       ssl_certificate_key /etc/letsencrypt/live/mail.your-domain.com/privkey.pem;
   
       location / {
           proxy_pass         http://127.0.0.1:8025;
           proxy_http_version 1.1;
           proxy_set_header   Upgrade $http_upgrade;
           proxy_set_header   Connection "upgrade";
           proxy_set_header   Host $host;
           proxy_read_timeout 86400;
       }
   }

   Activa el vhost y recarga Nginx:

   ln -s /etc/nginx/sites-available/mailpit /etc/nginx/sites-enabled/
   nginx -t && systemctl reload nginx

   Obtén un certificado Let's Encrypt si aún no lo has hecho:

   certbot --nginx -d mail.your-domain.com

4. 04

   Probar el envío con curl

   Verifica que el servidor SMTP recibe un mensaje:

   curl --url 'smtp://127.0.0.1:1025' \
     --mail-from '[email protected]' \
     --mail-rcpt '[email protected]' \
     --upload-file - <<EOF
   From: [email protected]
   To: [email protected]
   Subject: Mailpit Test
   
   Cuerpo del mensaje de prueba.
   EOF

   Abre https://mail.your-domain.com en tu navegador. El mensaje debe aparecer en la interfaz.

5. 05

   Configurar tu aplicación para apuntar a Mailpit

   En tu archivo .env (Laravel, Symfony, n8n, Django…), reemplaza la configuración SMTP con:

   MAIL_HOST=127.0.0.1
   MAIL_PORT=1025
   MAIL_ENCRYPTION=null
   MAIL_USERNAME=null
   MAIL_PASSWORD=null

   Para aplicaciones que corren en Docker en el mismo host, usa el nombre de red Docker o la IP de la pasarela (172.17.0.1 por defecto) en lugar de 127.0.0.1.

Mailpit en CI/CD: probar correos en el pipeline

Integración CI/CD por framework

1. 06

   GitHub Actions — servicio Mailpit

   services:
     mailpit:
       image: axllent/mailpit:latest
       ports:
         - 1025:1025
         - 8025:8025

   En las variables de entorno de tu job, define MAIL_HOST=127.0.0.1 y MAIL_PORT=1025. Mailpit acepta cualquier correo sin autenticación por defecto.

2. 07

   Laravel — PHPUnit

   En phpunit.xml, reemplaza el transporte con SMTP:

   <env name="MAIL_MAILER" value="smtp"/>
   <env name="MAIL_HOST" value="127.0.0.1"/>
   <env name="MAIL_PORT" value="1025"/>

   En tu test, envía el correo y consulta la API de Mailpit para verificar la recepción:

   $response = Http::get('http://127.0.0.1:8025/api/v1/messages');
   $this->assertSame($response->json('total'), 1);
   $this->assertStringContainsString(
       'Bienvenido',
       $response->json('messages.0.Subject')
   );

3. 08

   Django — pytest

   En settings.py (o settings_test.py):

   EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
   EMAIL_HOST = '127.0.0.1'
   EMAIL_PORT = 1025

   En tu test pytest, verifica mediante la API de Mailpit:

   import requests
   
   def test_welcome_email_sent():
       r = requests.get('http://127.0.0.1:8025/api/v1/messages')
       assert r.json()['total'] == 1
       assert 'Bienvenido' in r.json()['messages'][0]['Subject']

4. 09

   n8n — pruebas de flujo

   En el nodo Send Email de n8n, configura el servidor SMTP en 127.0.0.1:1025 sin autenticación. Para verificar automáticamente que un flujo de trabajo disparó un envío, llama a GET http://127.0.0.1:8025/api/v1/messages desde un nodo HTTP Request y valida el total en un nodo IF.

Asegurar el acceso a Mailpit

Resolución de problemas — 4 casos frecuentes

Mailpit vs MailHog vs Mailtrap vs Inbucket vs smtp4dev

Desplace la tabla

Casos de uso avanzados