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 oEMAIL_PORTno coincide.ImproperlyConfigured: Deprecated email settings are not allowed when MAILERS is defined— elimina los ajustesEMAIL_*y configura soloMAILERS.- 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.