Prueba los emails de Django en local en tu Mac

Captura cada email que envía tu app Django con un servidor SMTP local en tu Mac. Un bloque de configuración, un comando de prueba y ves cada email al instante.

El backend de consola de Django imprime los emails en tu terminal, lo cual sirve hasta que necesitas ver la versión HTML o revisar un adjunto. Con Mailbox, Django envía SMTP real a un servidor en tu Mac y cada email aparece completamente renderizado: HTML, texto plano, cabeceras y adjuntos. Nada se entrega a destinatarios reales.

1. Inicia un servidor en Mailbox

Abre Mailbox. La primera vez que lo abres crea un servidor en el puerto 2525 — asegúrate de que esté iniciado. Si en su lugar añades otro servidor, Mailbox le asigna un puerto libre; usa ese puerto en los pasos siguientes.

2. Actualiza tu configuración

Django 6.1 sustituyó los ajustes EMAIL_* por un único ajuste MAILERS, y los proyectos nuevos ya lo definen con el backend de consola. Edita ese bloque en tu configuración de desarrollo:

MAILERS = {
    "default": {
        "BACKEND": "django.core.mail.backends.smtp.EmailBackend",
        "OPTIONS": {"host": "127.0.0.1", "port": 2525},
    },
}

Indica el puerto explícitamente: sin TLS, Django usa el puerto 25 por defecto. No añadas ajustes EMAIL_* junto a MAILERS; Django se niega a arrancar si ambos están definidos.

Django 6.0 y anteriores

Los proyectos sin MAILERS usan los ajustes clásicos (en 6.1 siguen funcionando, con un aviso de obsolescencia):

EMAIL_BACKEND = "django.core.mail.backends.smtp.EmailBackend"
EMAIL_HOST = "127.0.0.1"
EMAIL_PORT = 2525
EMAIL_USE_TLS = False
EMAIL_USE_SSL = False

En ambos casos, no configures usuario ni contraseña: Mailbox no admite autenticación SMTP y Django falla con SMTPNotSupportedError si intenta iniciar sesión.

3. Envía un email de prueba

Django incluye un comando de gestión justo para esto:

python manage.py sendtestemail test@example.com

O desde python manage.py shell:

from django.core.mail import send_mail

send_mail("Hello from Django", "It works!", None, ["test@example.com"])

Ambos aparecen en Mailbox de inmediato. Los emails de restablecimiento de contraseña, los informes de error de mail_admins y tus propios EmailMultiAlternatives siguen el mismo camino.

Ejecutar Django en Docker

Dentro de un contenedor, 127.0.0.1 apunta al propio contenedor. Usa en su lugar la dirección de tu Mac: "host": "host.docker.internal" en MAILERS, o bien:

EMAIL_HOST = "host.docker.internal"

Si el contenedor sigue sin poder conectarse, activa Permitir acceso a la red en Mailbox (Configuración → General) y reinicia el servidor para que acepte conexiones desde fuera de la interfaz de loopback.

Solución de problemas

  • ConnectionRefusedError — el servidor de Mailbox no está en ejecución o EMAIL_PORT no coincide.
  • ImproperlyConfigured: Deprecated email settings are not allowed when MAILERS is defined — elimina los ajustes EMAIL_* y configura solo MAILERS.
  • Los emails se siguen imprimiendo en la terminal — otro módulo de configuración sigue usando el backend de consola; comprueba a qué módulo apunta DJANGO_SETTINGS_MODULE.
  • Las tareas de Celery no envían nada — los emails enviados desde tareas necesitan un worker en ejecución.

Qué revisar a continuación

Con emails reales delante, ejecuta la verificación de compatibilidad HTML para encontrar el CSS que clientes de correo como Outlook no renderizan, y usa la vista previa móvil para revisar tus plantillas responsive. Si pruebas varios proyectos, Mailbox Pro te permite dar a cada uno su propio servidor y puerto para que sus emails se mantengan separados.

Más guías