1. Was ist Docker?

Docker ist eine Software, die Programme in isolierten Umgebungen (sogenannten Containern) ausführt. Stell dir Container wie abgeschlossene Schachteln vor: Jede Schachtel enthält alles, was das Programm braucht, und stört andere Programme nicht.

APBoard nutzt mehrere Container:

• apboard — der PHP-Anwendungscontainer (Apache + PHP 8.5)
• db — die Datenbank (MariaDB)
• traefik (optional) — Reverse Proxy mit automatischem HTTPS

Der Vorteil: Du brauchst PHP, Apache und MariaDB nicht auf deinem Server zu installieren. Docker erledigt das für dich.

2. Docker installieren

Falls Docker noch nicht auf deinem Server installiert ist, folge diesen Schritten. Verbinde dich zuerst per SSH mit deinem Server.

Ubuntu / Debian (empfohlen)

# Altes Docker entfernen falls vorhanden
sudo apt remove docker docker-engine docker.io containerd runc 2>/dev/null

# Abhängigkeiten installieren
sudo apt update
sudo apt install -y ca-certificates curl gnupg lsb-release

# Offiziellen Docker-GPG-Key hinzufügen
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

# Docker-Repository hinzufügen
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Docker installieren
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# Docker-Dienst starten und autostart aktivieren
sudo systemctl enable --now docker

# Prüfen ob Docker läuft
docker --version
docker compose version

3. APBoard-Repository klonen

Lade den APBoard-Quellcode auf deinen Server herunter. Wähle ein Verzeichnis, in dem APBoard dauerhaft liegen soll.

# In das Zielverzeichnis wechseln (z.B. /opt oder dein Home-Verzeichnis)
cd /opt

# Repository klonen
git clone https://gitlab.apboard.de/app/apboard3.git apboard

# In das APBoard-Verzeichnis wechseln
cd apboard

Verzeichnisstruktur

Nach dem Klonen siehst du folgende Dateien und Ordner:

apboard/
├── docker-compose.yml          # Docker-Konfiguration (Hauptdatei)
├── docker-compose.traefik.yml  # Optionale Traefik-Erweiterung
├── .env.example                # Vorlage für deine Konfiguration
├── Dockerfile                  # Baut den PHP-Container
├── src/                        # APBoard PHP-Quellcode
│   ├── public/                 # Web-Root (index.php, Assets)
│   ├── config/                 # Konfigurationsdateien
│   ├── app/                    # Anwendungslogik
│   └── ...
└── storage/                    # Uploads, Logs (wird automatisch erstellt)

4. .env konfigurieren

Kopiere die Beispiel-Konfiguration und passe sie an:

cp .env.example .env
nano .env   # oder: vim .env

Alle .env-Variablen im Überblick

5. Setup wählen: Traefik oder Standalone

APBoard bietet zwei Docker-Setups:

Option A: Mit Traefik (empfohlen für neue Server)

Traefik ist ein Reverse Proxy, der automatisch HTTPS-Zertifikate von Let's Encrypt holt und verwaltet. Du brauchst nichts weiter zu konfigurieren — Traefik macht alles.

Traefik Minimal-Setup

Erstelle zuerst ein gemeinsames Docker-Netzwerk für Traefik:

docker network create traefik-public

Erstelle die Traefik-Konfigurationsdatei für ACME/Let's Encrypt:

touch acme.json
chmod 600 acme.json

Starte APBoard mit Traefik:

docker compose -f docker-compose.yml -f docker-compose.traefik.yml up -d

Option B: Standalone (ohne Traefik)

Das Standalone-Setup ist einfacher: APBoard läuft auf Port 80 ohne HTTPS. Du kannst HTTPS nachträglich mit einem vorhandenen Reverse Proxy (Nginx, Apache) einrichten, oder die Option für Produktiv-Betrieb nicht empfohlen nutzen.

# Einfach starten:
docker compose up -d

6. APBoard starten

Nachdem du die .env angepasst und das Setup gewählt hast:

# Container bauen und starten
docker compose up -d --build

# Logs verfolgen (Ctrl+C zum Beenden)
docker compose logs -f

# Status prüfen
docker compose ps

Beim ersten Start dauert es 1–3 Minuten, bis alle Container bereit sind. Das ist normal.

7. Was beim Start automatisch passiert

APBoard erledigt beim ersten Start folgende Schritte automatisch:

• Datenbanktabellen werden angelegt (Migrations)
• Ein Admin-Account wird erstellt (mit den Daten aus der .env)
• Standard-Konfiguration wird in der Datenbank gespeichert
• Ein Beispiel-Board und eine Beispiel-Kategorie werden erstellt
• Der APP_KEY wird automatisch generiert falls noch nicht gesetzt

8. Erster Login

Klicke oben rechts auf Anmelden und logge dich mit dem Admin-Account ein, den du in der .env konfiguriert hast (ADMIN_USERNAME / ADMIN_PASSWORD).

Nach dem ersten Login wirst du zum Admin-Panel weitergeleitet. Dort kannst du:

• Das Admin-Passwort ändern (unbedingt sofort tun!)
• Den Forum-Titel und die Beschreibung anpassen
• Kategorien und Boards anlegen
• Das Design auswählen

9. Nach der Installation

Forum-Struktur einrichten

Gehe im Admin-Panel zu Forum-Struktur. Dort legst du Kategorien und Boards an. Eine typische Anfangsstruktur:

• Kategorie: Allgemeines
• Board: Vorstellungen, Off-Topic
• Kategorie: Themenspezifisch
• Board: [Dein Hauptthema]

E-Mail testen

Registriere einen Test-Account, um sicherzustellen, dass E-Mails ankommen. Wenn keine E-Mail ankommt, überprüfe die SMTP-Einstellungen in der .env.

Backups einrichten

Richte regelmäßige Backups ein. Wichtig sind:

• Die Datenbank: docker compose exec db mysqldump -u root -p apboard > backup.sql
• Das storage/-Verzeichnis (Uploads)
• Die .env-Datei

10. Nützliche Docker-Befehle

11. APBoard aktualisieren

Ausführliche Informationen zum Update-Prozess findest du auf der Seite APBoard aktualisieren. Kurzversion:

cd /opt/apboard
git pull
docker compose up -d --build

12. Fehlerbehebung

Container startet nicht

Prüfe die Logs:

docker compose logs apboard
docker compose logs db

Datenbank-Verbindungsfehler

Häufigste Ursache: Die .env-Variablen für die Datenbank stimmen nicht. Prüfe insbesondere DB_PASSWORD und MYSQL_ROOT_PASSWORD — sie müssen nach dem ersten Start konsistent sein. Wenn du sie nach dem ersten Start änderst, musst du auch die Datenbank neu erstellen oder das Passwort in MariaDB manuell ändern.

Port 80 / 443 bereits belegt

# Prüfen welcher Prozess den Port belegt:
ss -tlnp | grep ':80'
ss -tlnp | grep ':443'

Häufig belegt Apache oder Nginx den Port. Stoppe den Dienst: sudo systemctl stop apache2 oder sudo systemctl stop nginx.

Domain zeigt nicht auf den Server

Prüfe ob die DNS-Propagation abgeschlossen ist:

nslookup forum.meine-domain.de
# oder
dig forum.meine-domain.de +short

HTTPS-Zertifikat wird nicht ausgestellt (Traefik)

Let's Encrypt benötigt, dass die Domain bereits öffentlich auf den Server zeigt (Port 80 erreichbar). Prüfe:

• Ist Port 80 in der Firewall freigegeben? (ufw allow 80)
• Zeigt die Domain bereits auf die Server-IP?
• Läuft Traefik? (docker compose ps)

Schaue in die Traefik-Logs:

docker compose logs traefik | grep -i acme

Seite lädt, aber CSS / Bilder fehlen

Wahrscheinlich ist APP_URL in der .env falsch gesetzt. Der Wert muss exakt der URL entsprechen, über die das Forum erreichbar ist, inkl. https:// und ohne abschließenden Schrägstrich.