Zum Inhalt springen

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.

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”.
  • Das Start-Log nennt das Problem: eine Warnung, wenn kein Mailserver konfiguriert ist, ein Fehler, wenn der konfigurierte nicht erreichbar ist.
  • Auf einer frischen Instanz ohne Konto meldet auch die Login-Seite einen konfigurierten, aber nicht erreichbaren Mailserver. Der Hinweis verschwindet, sobald das erste Konto existiert.
Abschnitt betitelt „Ausgesperrt? Anmeldelink auf dem Server ausstellen“

Wenn die Mail nicht funktioniert und du nicht hineinkommst (erster Start ohne Mailserver, oder der Mailserver ist später ausgefallen und du hast keinen Passkey), stell im App-Container einen Anmeldelink aus:

Terminal-Fenster
docker exec -it <container> node scripts/login-link.mjs du@example.com

Der Befehl gibt einen Link aus, der 15 Minuten gültig ist und einmal funktioniert. Öffne ihn im Browser.

  • Er funktioniert für ein bestehendes Konto oder für jede Adresse, solange die Instanz noch kein Konto hat (dann entsteht das erste).
  • Die Zwei-Faktor-Anmeldung gilt weiterhin. Ein gesperrtes Konto bekommt keinen Link.
  • Der Link erscheint nur in deinem Terminal, nie in den Logs. Wird er benutzt, steht das im Audit-Log, und der Nutzer sieht einen Hinweis.

Behebe danach die Mail-Einstellungen und füge unter Einstellungen → Sicherheit einen Passkey hinzu, damit die Anmeldung nicht mehr an der Mail hängt.

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.
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

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.

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.