E-Mail- & SMTP-Fehlersuche

Mehrere Abläufe hängen vom ausgehenden E-Mail-Versand ab: Magic-Link-Login, Team-Einladungen, E-Mail-Adress-Änderungen (samt Sicherheitsbenachrichtigungen) und Kontolöschungs-Bestätigungen. Wenn etwas davon „nicht ankommt”, arbeite die folgenden Prüfungen durch.

1. Ist SMTP überhaupt konfiguriert?

Orimora versendet nur dann E-Mails, wenn ein echter SMTP-Server konfiguriert ist. Andernfalls werden die E-Mail-abhängigen Aktionen in der Oberfläche deaktiviert (mit einem Hinweis) — statt scheinbar zu funktionieren und still fehlzuschlagen.

• Ist das E-Mail-Wechsel-Formular, das Einladungsformular oder der Magic-Link-Login ausgegraut, ist SMTP nicht eingerichtet. Konfiguriere die SMTP_*-Variablen — siehe Konfiguration → SMTP — und starte die App neu.
• Der Standardwert SMTP_HOST=localhost:1026 ist der lokale Mailpit-Platzhalter; in Produktion gilt er als „nicht konfiguriert”.

2. Den Live-Verbindungstest ausführen

Ein Systemadministrator kann die Verbindung unter Einstellungen → Admin → SMTP testen prüfen, ohne eine echte Nachricht zu senden. Dabei wird die Verbindung aufgebaut und authentifiziert:

• Grün — Orimora erreicht den Server und kann sich anmelden. Kommt trotzdem keine Mail an, liegt das Problem weiter hinten (Empfänger, Spam, Absender-Reputation) — weiter unten.
• Rot — die Fehlermeldung zeigt die Ursache (Host nicht erreichbar, Auth abgelehnt, TLS-Handshake fehlgeschlagen). Korrigiere die SMTP_*-Einstellungen und teste erneut.

3. Häufige Ursachen

Symptom	Wahrscheinliche Ursache / Lösung
Connection refused / Timeout	Falscher SMTP_HOST/SMTP_PORT, oder die Firewall blockiert ausgehend 587/465
Authentifizierung fehlgeschlagen	Falscher SMTP_USER/SMTP_PASSWORD; manche Provider brauchen ein App-spezifisches Passwort
TLS-/STARTTLS-Handshake fehlgeschlagen	Port 587 (STARTTLS) oder 465 (implizites TLS) nutzen; Orimora erzwingt TLS außer localhost
Gesendet, aber nie zugestellt	Spam-Ordner des Empfängers, oder der Provider lehnt die SMTP_FROM-Adresse ab (SPF/DKIM/DMARC)
Bei manchen zugestellt, bei anderen nicht	Domain-Filter beim Empfänger; Suppression-/Bounce-Liste des Providers prüfen

Absender-Reputation

Nutze eine SMTP_FROM-Adresse auf einer Domain, die du kontrollierst, mit SPF- und DKIM-Einträgen, die auf deinen SMTP-Provider zeigen. Mail von einem nicht passenden oder nicht authentifizierten Absender ist der häufigste Grund, warum Nachrichten still verworfen oder als Spam einsortiert werden.

4. Zustellung ist asynchron

Ausgehende E-Mails werden in eine Queue gelegt (Redis-gestützt) und von einem Hintergrund-Worker versendet — ein Klick kehrt also sofort zurück, obwohl die Zustellung einen Moment später erfolgt. Vorübergehende SMTP-Fehler werden automatisch wiederholt. Ein dauerhafter Fehler (z. B. falsche Zugangsdaten) wird wiederholt und dann aufgegeben — prüfe die Anwendungs-Logs auf den Sendefehler und stelle sicher, dass Redis/der Worker läuft.

5. Lokale Entwicklung

Für die lokale Entwicklung bringt Orimora Mailpit mit (localhost:1026): Jede Nachricht wird in dessen Web-UI abgefangen statt zugestellt, sodass alle E-Mail-Abläufe ohne echten Provider durchlaufen.

Siehe auch

• Konfiguration → SMTP — die SMTP_*-Variablen
• Teammitglieder — Einladungen und E-Mail-Wiederherstellung
• Sicherheit — Magic-Link-Login und E-Mail-Änderungen