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.