APBoard v3 · Dokumentation
Dokumentation

Alles was du brauchst, um APBoard zu installieren, zu konfigurieren und zu betreiben. Ausführlich erklärt, auch für absolute Einsteiger.

APBoard › Dokumentation

APBoard v3 Dokumentation

Diese Anleitung erklärt, wie du APBoard v3 installierst, konfigurierst, aktualisierst und betreibst. Sie richtet sich ausdrücklich auch an Menschen, die Docker, Apache, nginx oder MariaDB noch nie benutzt haben.

Welche Installation passt zu dir?

Nutze Docker, wenn du einen eigenen Server oder VPS hast. Docker bringt PHP, Apache und MariaDB passend mit. Nutze die Installation auf einem normalen Webserver, wenn du bereits Hosting mit Apache oder nginx, PHP 8.5 und einer MySQL kompatiblen Datenbank hast.

Die zwei unterstützten Installationswege

Docker Installation

APBoard läuft in zwei Containern: ein App Container mit PHP 8.5 und Apache, und ein MariaDB 10.6 Datenbankcontainer. Der App Container erzeugt config.php, installiert bei Bedarf Composer Pakete, bereitet Asset Links vor und legt den ersten Admin an.

  • Beste Wahl für VPS und eigene Server
  • Keine manuelle PHP oder Apache Einrichtung auf dem Hostsystem
  • Gut geeignet hinter Traefik für automatisches HTTPS
  • Nutzt deploy/.env als zentrale Konfiguration
Docker Anleitung lesen
Normaler Webserver

APBoard wird auf einen normalen Webspace kopiert. Apache oder nginx liefert ausschließlich das Verzeichnis public/ aus. Der Setup Assistent im Browser importiert die Datenbank, schreibt config.php und erstellt den ersten Admin.

  • Funktioniert mit Apache oder nginx
  • Erfordert PHP 8.5 und die nötigen PHP Erweiterungen
  • Erfordert MariaDB 10.6 oder MySQL 8.0
  • Nutzt /setup/ für die Erstinstallation
Webserver Anleitung lesen

Lies am besten in dieser Reihenfolge

Seite Was dort erklärt wird
VoraussetzungenServer, Domain, SSH, Datenbank, PHP Anforderungen und wichtige Grundbegriffe.
Docker InstallationDocker installieren, APBoard klonen, .env konfigurieren, Container starten und Forum prüfen.
Installation auf Apache oder nginxAPBoard auf einem normalen Webserver mit PHP und MariaDB oder MySQL installieren.
KonfigurationAlle wichtigen Werte in .env und config.php, einschließlich SMTP, URL und Datenbank.
Nach der InstallationErster Login, Kategorien, Boards, rechtliche Seiten, Mailtest und Startprüfung.
APBoard aktualisierenBackups, Docker Updates, Updates auf normalen Webservern und automatische Migrationen.
FehlerbehebungHäufige Probleme bei Installation, Routing, Datenbank, Rechten, Mail und Updates.

Wo du APBoard bekommst

Der APBoard Quellcode liegt auf dem eigenen Forgejo Server des Projekts. Docker Installationen klonen normalerweise das Git Repository. Installationen auf normalen Webservern sollten ein Release ZIP verwenden, das vendor/ bereits enthält.

APBoard auf Forgejo öffnen

Wichtige Sicherheitsregel

Richte deinen Webserver niemals auf das APBoard Wurzelverzeichnis. Der öffentliche Webroot ist immer public/. Dateien wie config.php, engine/, libs/ und setup/mysql/ dürfen im Browser nicht direkt erreichbar sein.

Weiter Voraussetzungen