Diese Übersicht sammelt Probleme, die bei Installation und Betrieb wirklich aufgetreten sind oder häufig vorkommen. Zuerst die schnelle Diagnose, dann die Tabelle.
Schnelle Diagnose
- Seite mit Strg + F5 neu laden (Cache).
- Das Fehlerprotokoll öffnen (System › System-Check, ganz unten). Dort steht die Meldung des Systems.
- Den System-Check ansehen: sind alle Migrationen ausgeführt?
- Beim Hoster das PHP-Fehlerprotokoll ansehen (bei HTTP 500).
- Zuletzt eingespieltes Update und seine Version notieren.
Tabelle
| Beobachtung | Ursache | Lösung |
|---|---|---|
| „Noch nicht installiert. Bitte zuerst setup.php aufrufen.“ (HTTP 500) | Es gibt noch keine config/config.php. | /setup.php aufrufen und den Assistenten durchlaufen (Kapitel 2). |
| Setup: „Verbindung zur Datenbank fehlgeschlagen“ | Server, Datenbankname, Benutzer oder Passwort falsch; bei webgo ist der Server meist nicht „localhost“. | Zugangsdaten beim Hoster prüfen und exakt übernehmen. |
| Setup nach der Installation erneut aufgerufen: 403 | Gewollt: Die Installation ist abgeschlossen und gesperrt. | Keine Aktion nötig. Für eine Neuinstallation config/config.php entfernen. |
| Setup zeigt am Ende „bereits abgeschlossen“ statt der Abschlussseite | Fehler in Versionen vor 2026.10.11.3. | Harmlos, die Installation ist fertig. Mit Update V3 oder neuer behoben. |
| HTTP 500 nach einem Update | Fehler in einer geänderten Datei. Beispiel: ein HSTS-Header in bootstrap.php führte beim Hoster zu einem 500. | Hoster-Fehlerprotokoll lesen, betroffene Datei aus storage/update_backups zurückholen, Fehler melden. |
| „Die Version des Pakets … ist nicht neuer als die installierte“ | Das Paket ist eingespielt oder älter; oder die Version wurde nicht erhöht. | Installierte Version prüfen. Sammelpaket mit höherer Version verwenden. |
| Update lässt sich nicht hochladen | Upload-Grenze des Servers (upload_max_filesize, post_max_size). | Werte in .user.ini erhöhen (webgo), nicht in .htaccess. |
| Nach Update sieht alles unverändert aus | Browser- oder App-Cache (Service Worker). | Strg + F5; App einmal ganz schließen und neu öffnen. |
| Anmelden geht nicht, Passwort vergessen | Passwort unbekannt. | „Passwort vergessen“ nutzen. Das System benachrichtigt zugleich die Verwaltung (Push und, wenn eingerichtet, E-Mail mit Link zur Konten-Freischaltung); sie hilft beim neuen Zugang (Kapitel 4). |
| Mitglied war deaktiviert und soll wieder rein | Konto ist deaktiviert. | In der Mitgliederliste das Mitglied öffnen und reaktivieren (Kapitel 6). |
| Gruppe oder Rolle lässt sich nicht löschen | Sie kommt in der Historie vor (beendete Mitgliedschaften). | „Löschen“ archiviert sie; im Bereich „Archiv“ am Seitenende lässt sie sich wiederherstellen. |
| Kalender: Spalten unterschiedlich breit | Lange Titel dehnten die Spalten (Änderungsprotokoll 2026-10-09 (2)). | Update einspielen. Die Spalten sind jetzt gleich breit. |
| Katzen oder Hunde bei „Betroffene Tiere“ im Reitverein-Kurs | Tier-Art oder Bereich falsch; bis 2026.10.10.1 wurde nach Art gefiltert. | Häkchen „Für Events und Kurse wählbar“ am Tier prüfen (Kapitel 8). |
| Menüpunkt fehlt (Reitverein, Schichtplan, Buchhaltung …) | Erweiterung ausgeschaltet, im Mitgliederbereich ausgeblendet, oder keine Berechtigung. | System › Erweiterungen und System › Einstellungen › Mitgliederbereich prüfen, dann die Rolle. |
| Reitplatz-Buchung: Tier fehlt | Tier „nicht buchbar“ oder in dieser Zeit vergeben. | Tierprofil prüfen (Kapitel 8). |
| E-Mails kommen nicht an | SMTP-Zugang, Port, Verschlüsselung oder Absender falsch; Spam-Ordner. | Mail-Einstellungen prüfen (Kapitel 13), Fehlerprotokoll lesen. |
| Postfach: „Mailbox doesn't exist: Posteingang“ | Der Ordner heißt für den Mailserver „INBOX“. | Ordner „INBOX“ eintragen; neuere Versionen erkennen „Posteingang“ selbst. |
| Webmail startet nicht | PHP-Erweiterungen intl, pdo_sqlite oder openssl fehlen. | Beim Hoster aktivieren (Kapitel 2). |
| PDF (Mitgliedskarte, Rechnung) bleibt weiß | Schrift-Definitionen von FPDF fehlten (Änderungsprotokoll 2026-10-03). | Aktuelles Update einspielen. |
| Android-App lässt sich nicht installieren | Browser-Berechtigung für die Installation fehlt. | Anleitung auf der Seite App installieren (Kapitel 4) beachten; „Zum Startbildschirm“ erlauben. |
| Push-Nachrichten kommen nicht an | Benachrichtigungen im Browser oder Handy blockiert. | In den Browser-Einstellungen der Seite „Benachrichtigungen“ erlauben. |
| Buchungsmaske zeigt keine Konten | SKR-42-Konten fehlen. | Kontenrahmen importieren (Kapitel 12). |
| Export wird vom Steuerberater abgelehnt | DATEV-Stammdaten fehlen oder Zuordnung der Konten stimmt nicht. | Beraternummer, Mandantennummer, Wirtschaftsjahr und Konten gemeinsam prüfen. |
| Eltern sehen „Meine Kinder“ nicht | Kind nicht verknüpft, kein Geburtsdatum oder volljährig (Jahr des 18. Geburtstags vorbei). | Verknüpfung und Geburtsdatum bei Personen prüfen (Kapitel 16). |
| Ein Kind sieht die Kinderwelt nicht | Erweiterung ausgeschaltet oder von den Eltern nicht freigeschaltet. | System › Erweiterungen prüfen; Eltern schalten unter Meine Kinder ein (Kapitel 16). |
| Nutzer müssen sich ständig neu anmelden | „Angemeldet bleiben“ ist nicht angekreuzt; ohne Häkchen endet die Sitzung nach etwa 24 Minuten Ruhe. | Beim Login ankreuzen (Kapitel 4). Nach einem Passwortwechsel muss man sich einmal neu anmelden. |
| Eine Aufgabe lässt sich nicht abhaken | Sie hat ein Schicht-Zeitfenster, das gerade nicht läuft. | Ist gewollt. Der Hinweis nennt den Zeitpunkt (Kapitel 10). |
Tipp: Notiere bei jedem Fehler die Version (unten auf jeder Seite), die Uhrzeit und die genaue Meldung. Das Fehlerprotokoll im System-Check zeigt dann meistens sofort die Zeile, in der es klemmt.