Django-E-Mails lokal auf Ihrem Mac testen

Jede E-Mail Ihrer Django-App mit einem lokalen SMTP-Server auf dem Mac abfangen. Ein Settings-Block, ein Testbefehl, und Sie prüfen jede E-Mail sofort.

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, oder EMAIL_PORT stimmt nicht überein.
  • ImproperlyConfigured: Deprecated email settings are not allowed when MAILERS is defined — entfernen Sie die EMAIL_*-Settings und konfigurieren Sie ausschließlich MAILERS.
  • E-Mails erscheinen weiterhin im Terminal — ein anderes Settings-Modul verwendet noch das Console-Backend; prüfen Sie, auf welches Modul DJANGO_SETTINGS_MODULE zeigt.
  • 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.

Weitere Anleitungen