Betrieb

Störungssuche

Beobachtung Wahrscheinliche Ursache Vorgehen
Profil meldet „Diese Adresse ist nicht bestätigt" So legt der Installer den ersten Administrator an; eingeladene Konten sind es bis zur Annahme der Einladung Einstellungen → E-Mail einrichten, dann Konto → Profil → „Bestätigungsmail senden" und den Link anklicken
Die Bestätigungsmail kommt nicht an Adresse falsch geschrieben, oder der Versand ist nicht in Ordnung Test-Mail in Einstellungen → E-Mail. Bei falscher Adresse: Der Nutzer ändert sie selbst unter Konto → Profil (ein Administrator kann fremde Adressen nicht ändern)
Keine Mails Zugang falsch oder Provider blockiert Einstellungen → E-Mail → „Test-Mail senden" oder php artisan formrelay:mail-test; die Fehlermeldung steht im Klartext da
Mails landen im Spam SPF/DKIM fehlen, Absender passt nicht zur Domain Hinweise unter Einstellungen → E-Mail, siehe Zustellbarkeit
Warnung „Der Mail-Versand ist nicht geprüft" Bei der Installation übersprungen oder seit einer Änderung nicht getestet Einstellungen → E-Mail → „Test-Mail senden"
Website meldet „Die Nachricht ließ sich keiner Website zuordnen" (403) Der Browser schickt keine Herkunft: Referrer-Policy: no-referrer oder same-origin auf der Seite, oder action beginnt mit http:// Policy auf die Vorgabe der Browser lassen, action mit https:// (Einbauen)
„Dieses Formular gehört zu einer anderen Website" (403) Die Domain steht nicht beim Formular, oder die Seite läuft über http:// Domain eintragen — mit und ohne www sind zwei
„Dieses Formular ist noch nicht fertig eingerichtet" (503) Kein Empfänger hat seine Adresse bestätigt Detailseite → Empfänger: Bestätigung erneut senden
„Dieses Formular nimmt gerade nichts an" (410) pausiert oder durch die Aufsicht stillgelegt „Nimmt Einsendungen an" setzen bzw. Aufsicht
„Dieses Formular gibt es nicht" (404) Token erneuert oder Formular gelöscht neue Adresse ins action-Attribut
Einsendungen „unzustellbar" Mailserver lehnt ab oder ist nicht erreichbar; Ursache steht in der Liste Versand reparieren, dann „Erneut zustellen"
Einsendungen bleiben „in Zustellung" Der Queue-Worker läuft nicht Cron für queue:work prüfen; der Aufräumlauf reiht Zustellungen nach 24 Stunden neu ein
Empfänger bekommt keine Bestätigungsmail Adresse falsch, Mail im Spam, kein Versand eingerichtet Adresse prüfen, „Bestätigung erneut senden" (72 Stunden gültig)
Aufträge der Warteschlange bleiben liegen Der Queue-Worker läuft nicht Cron-Eintrag für queue:work setzen (Cron einrichten). Einstellungen → Systemdaten zeigt den letzten Lauf
Warnung „Cron-Eintrag … ist offenbar nicht eingerichtet" Der Befehl ist auf dieser Installation noch nie gelaufen Eintrag setzen; die fertige Zeile steht unter Einstellungen → Systemdaten, „Zeitsteuerung (Cron)"
Logo erscheint nicht public/storage fehlt php artisan storage:link
Oberfläche ohne Gestaltung public/build/ fehlt Beim Weg über das Repository: npm ci && npm run build und public/build/ hochladen
Änderung an .env wirkt nicht Konfiguration zwischengespeichert php artisan config:cache
Neue Seite zeigt 404 Seite nicht veröffentlicht Häkchen „Veröffentlicht" setzen
Slug einer Seite wird abgelehnt Er ist reserviert oder schon vergeben anderen wählen — Liste unter Seiten
„Kopieren" funktioniert nicht Kein HTTPS (kein sicherer Kontext) TLS einrichten; der Text lässt sich derweil markieren
Uhrzeiten liegen ein bis zwei Stunden daneben APP_TIMEZONE weicht von der Zone der Nutzer ab Passende Zone setzen. Achtung: nur vor dem ersten Produktivdatensatz
Niemand kommt mehr in ein Konto (2FA verloren) Gerät und Codes weg Nutzer → „Zwei-Faktor zurücksetzen", nach Rückfrage auf anderem Weg

Für Support-Anfragen: Einstellungen → Systemdaten → „Bericht kopieren". Er enthält alle Betriebswerte und keine Geheimnisse.

Quelle dieser Seite: docs/betrieb/stoerungssuche.md im Repository. Sie wird beim Bauen daraus erzeugt — Änderungen gehören in die Markdown-Datei, nicht in diese Seite.