Das Console-Backend von Django gibt E-Mails im Terminal aus. Das funktioniert, bis Sie die HTML-Version sehen oder einen Anhang prüfen müssen. Mit Mailbox sendet Django echtes SMTP an einen Server auf Ihrem Mac, und jede E-Mail erscheint vollständig gerendert — HTML, Klartext, Header und Anhänge. An echte Empfänger wird nichts zugestellt.
1. Server in Mailbox starten
Öffnen Sie Mailbox. Beim ersten Start legt Mailbox einen Server auf Port 2525 an — stellen Sie sicher, dass er gestartet ist. Wenn Sie stattdessen einen weiteren Server hinzufügen, wählt Mailbox dafür einen freien Port; verwenden Sie dann diesen Port in den folgenden Schritten.
2. Settings anpassen
Django 6.1 hat die EMAIL_*-Settings durch eine einzige Einstellung MAILERS ersetzt, und neue Projekte definieren sie bereits mit dem Console-Backend. Bearbeiten Sie diesen Block in Ihren Development-Settings:
MAILERS = {
"default": {
"BACKEND": "django.core.mail.backends.smtp.EmailBackend",
"OPTIONS": {"host": "127.0.0.1", "port": 2525},
},
}
Setzen Sie den Port explizit — ohne TLS verwendet Django standardmäßig Port 25. Fügen Sie keine EMAIL_*-Settings neben MAILERS hinzu; Django startet nicht, wenn beide definiert sind.
Django 6.0 und älter
Projekte ohne MAILERS verwenden die klassischen Settings (unter 6.1 funktionieren sie weiterhin, allerdings mit einer Deprecation-Warnung):
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
Setzen Sie in beiden Fällen keinen Benutzernamen und kein Passwort: Mailbox unterstützt keine SMTP-Authentifizierung, und Django bricht mit SMTPNotSupportedError ab, wenn es versucht, sich anzumelden.
3. Test-E-Mail senden
Django bringt genau dafür einen Management-Befehl mit:
python manage.py sendtestemail test@example.com
Oder aus python manage.py shell heraus:
from django.core.mail import send_mail
send_mail("Hello from Django", "It works!", None, ["test@example.com"])
Beide erscheinen sofort in Mailbox. Passwort-Reset-E-Mails, Fehlerberichte über mail_admins und Ihre eigenen EmailMultiAlternatives nehmen denselben Weg.
Django in Docker betreiben
In einem Container verweist 127.0.0.1 auf den Container. Verwenden Sie stattdessen die Adresse Ihres Macs — "host": "host.docker.internal" in MAILERS oder:
EMAIL_HOST = "host.docker.internal"
Falls der Container weiterhin keine Verbindung herstellen kann, aktivieren Sie in Mailbox Netzwerkzugriff erlauben (Einstellungen → Allgemein) und starten Sie den Server neu, damit er auch Verbindungen von außerhalb des Loopback-Interfaces annimmt.
Fehlerbehebung
ConnectionRefusedError— der Mailbox-Server läuft nicht, oderEMAIL_PORTstimmt nicht überein.ImproperlyConfigured: Deprecated email settings are not allowed when MAILERS is defined— entfernen Sie dieEMAIL_*-Settings und konfigurieren Sie ausschließlichMAILERS.- E-Mails erscheinen weiterhin im Terminal — ein anderes Settings-Modul verwendet noch das Console-Backend; prüfen Sie, auf welches Modul
DJANGO_SETTINGS_MODULEzeigt. - Celery-Tasks senden nichts — E-Mails aus Tasks brauchen einen laufenden Worker.
Als Nächstes prüfen
Sobald echte E-Mails vor Ihnen liegen, führen Sie die HTML-Kompatibilitätsprüfung aus, um CSS zu finden, das E-Mail-Clients wie Outlook nicht darstellen, und prüfen responsive Templates mit der Mobilvorschau. Wenn Sie mehrere Projekte testen, geben Sie mit Mailbox Pro jedem seinen eigenen Server und Port, sodass ihre E-Mails getrennt bleiben.