Fehlerbehebung

Docker Container startet nicht

Prüfe zuerst Status und Logs aus dem Verzeichnis deploy/.

cd /home/apboard/forum/deploy
docker compose ps
docker compose logs --tail 200 app
docker compose logs --tail 200 db

Wenn die Datenbank nicht gesund ist, prüfe die Passwörter in .env und ob deploy/db/ bereits eine alte Datenbank enthält, die mit anderen Zugangsdaten initialisiert wurde. Wenn die App nicht gesund ist, prüfe APBOARD_URL, APBOARD_DB_HOST und das Datenbankpasswort.

Traefik zeigt 404 oder kein Zertifikat

Ein Traefik 404 bedeutet meistens, dass die Router Regel nicht zu deiner Domain passt oder dass der Container nicht mit dem Netzwerk proxy verbunden ist.

docker network inspect proxy
docker compose config | grep APBOARD_DOMAIN
docker compose ps

Für Zertifikate muss die Domain bereits auf den Server zeigen. Außerdem müssen Port 80 und 443 aus dem Internet erreichbar sein.

Setup Assistent erscheint nicht

Der Setup Assistent erscheint nur, wenn config.php nicht existiert. Wenn config.php existiert, behandelt APBoard die Installation als abgeschlossen und leitet /setup/ zum Forum weiter.

Bei Docker ist das erwartet. Docker erzeugt config.php, bevor Apache startet. Docker Installationen nutzen den Browser Setup Assistenten nicht.

Datenbankverbindung fehlgeschlagen

Prüfe zuerst den Datenbankhost. In Docker muss er db heißen. Auf einem normalen Server ist es oft localhost oder 127.0.0.1.

# Docker
cd /home/apboard/forum/deploy
docker compose exec db mariadb -u apboard -p apboard

# Normaler Server
mysql -u apboard -p apboard

Wenn der Login fehlschlägt, sind Datenbankbenutzer, Passwort oder Datenbankname falsch. Wenn der Login funktioniert, aber APBoard scheitert, vergleiche diese Werte mit .env oder config.php.

CSS, JavaScript oder Icons fehlen

APBoard liefert Frontend Bibliotheken über Symlinks in public/assets/ aus. Docker erstellt sie bei jedem Containerstart. Der normale Setup Assistent erstellt sie nach der Installation.

ls -la public/assets
ls -la public/assets/js
ls -la public/assets/font-awesome

Bei Apache muss Options FollowSymLinks für das Verzeichnis public/ aktiv sein. Bei nginx müssen die Symlinks auf lesbare Ziele zeigen.

URLs liefern 404 außer der Startseite

Die Rewrite Regeln des Webservers fehlen oder sind unvollständig. APBoard braucht einen Fallback auf index.php und ausdrückliche Regeln für ActivityPub und Well Known Endpunkte. Vergleiche deine Apache oder nginx Konfiguration mit den Beispielen in der Installationsanleitung für normale Webserver.

Uploads schlagen fehl

Der Webserver muss in public/shared/uploads/ schreiben dürfen. Außerdem müssen die PHP Upload Limits groß genug für die Dateien sein, die du im Admin Bereich erlaubst.

ls -ld public/shared public/shared/uploads
php -i | grep -E 'upload_max_filesize|post_max_size|memory_limit'

E Mails kommen nicht an

Prüfe Host, Port, Sicherheitsmodus, Benutzername, Passwort, Absenderadresse und Absendername. Nutze starttls mit Port 587 und smtps mit Port 465, außer dein Mailanbieter gibt etwas anderes vor.

Prüfe auch den Spam Ordner. Wenn E Mails im Spam landen, richte SPF, DKIM und DMARC für deine Absenderdomain ein oder nutze einen vertrauenswürdigen Mailanbieter.

Admin Passwort vergessen

Nutze den normalen Passwort Zurücksetzen Ablauf, wenn Mail funktioniert. Wenn Mail nicht funktioniert, erstelle einen PHP Passwort Hash und aktualisiere die Admin Zeile in der Datenbank.

php -r "echo password_hash('NeuesStarkesPasswort', PASSWORD_DEFAULT);"

UPDATE apb_user SET password = 'HASH_HIER_EINFÜGEN' WHERE id = 1;

Hilfe anfragen

Wenn du im APBoard Forum oder auf Forgejo nach Hilfe fragst, nenne Installationsart, APBoard Version, PHP Version, Datenbankversion, Webserver und genaue Fehlermeldungen. Bei Docker sind außerdem docker compose ps und die letzten App Logs hilfreich. Entferne vorher Passwörter.