APBoard mit Docker installieren

1. Mit dem Server verbinden

Öffne ein Terminal auf deinem Computer und verbinde dich per SSH mit deinem Server. Ersetze die IP Adresse durch die Adresse deines Servers.

ssh root@203.0.113.10

2. Docker und Git installieren

Auf Ubuntu oder Debian installierst du Docker aus dem offiziellen Docker Repository. Die folgenden Befehle sehen lang aus, fügen aber nur die Paketquelle hinzu und installieren Docker Compose.

apt update
apt install ca-certificates curl git

install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" > /etc/apt/sources.list.d/docker.list

apt update
apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Prüfe danach, ob die Befehle funktionieren:

docker --version
docker compose version
git --version

3. Verzeichnis vorbereiten

Wähle einen dauerhaften Ort für APBoard. Das Beispiel nutzt /home/apboard. Du kannst einen anderen Pfad wählen, solltest ihn später aber konsequent verwenden.

mkdir -p /home/apboard
cd /home/apboard
git clone https://forge.chrislo.de/APBoard/apboard3.git forum
cd forum

4. Docker Konfiguration erstellen

Docker liest die APBoard Einstellungen aus deploy/.env. Das Repository enthält eine Vorlage. Kopiere sie und bearbeite deine eigene Datei.

cd /home/apboard/forum/deploy
cp .env.example .env
nano .env

Ändere mindestens diese Werte:

chmod 600 /home/apboard/forum/deploy/.env

5. Entscheiden, wie HTTPS APBoard erreicht

Die mitgelieferte docker-compose.yml erwartet einen Traefik Reverse Proxy mit einem externen Docker Netzwerk namens proxy. Traefik nimmt Anfragen auf Port 80 und 443 an und leitet passende Anfragen an APBoard weiter.

docker network ls | grep proxy

# Falls es noch nicht existiert:
docker network create proxy

Wenn du Traefik nicht nutzt, kannst du Docker trotzdem verwenden. Dann musst du die Compose Datei so anpassen, dass ein Host Port veröffentlicht wird, und Apache, nginx oder einen anderen Proxy davor setzen. Für eine produktive Erstinstallation ist Traefik oft einfacher, weil es HTTPS Zertifikate automatisch anfordern kann.

6. APBoard starten

Führe Docker Compose aus dem Verzeichnis deploy/ aus. Der erste Start kann einige Minuten dauern, weil Docker das Image baut und Composer PHP Pakete installiert.

cd /home/apboard/forum/deploy
docker compose up -d --build

7. Start beobachten

Mit den Logs siehst du, was passiert. Die Datenbank startet, der App Container bereitet Dateien vor und Apache beginnt mit dem Ausliefern.

docker compose ps
docker compose logs -f app
docker compose logs -f db

Die App ist bereit, wenn docker compose ps den App Container als healthy anzeigt.

8. Was automatisch passiert

Der Docker Entrypoint erledigt die Aufgaben, die bei einer normalen Installation der Web Installer übernimmt. Er erzeugt public/assets/, public/shared/uploads/, public/sitemap.xml und die nötigen Symlinks für Bootstrap, jQuery, Font Awesome, TinyMCE, Klaro und Stylesets.

Er führt außerdem composer install aus, wenn vendor/autoload.php fehlt oder veraltet ist, schreibt config.php aus den Umgebungsvariablen und ruft setup/docker-init.php auf, um den ersten Admin anzulegen. Die Datenbankstruktur kommt aus setup/mysql/initial-setup-dump.sql, das MariaDB beim ersten leeren Datenbankstart importiert.

9. Forum öffnen

Öffne die URL aus APBOARD_URL, zum Beispiel https://forum.example.com. Melde dich unter /login/ mit APBOARD_FIRST_ADMIN_EMAIL und APBOARD_FIRST_ADMIN_PASSWORD an.