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 aktualisieren

APBoard aktualisieren

Updates ersetzen die Anwendungsdateien und können beim nächsten Aufruf automatisch Datenbankmigrationen ausführen. Erstelle vor jedem Update ein Backup.

Erst sichern

Ein Backup ist dein Rückweg, wenn ein Release, ein Serverbefehl oder eine Migration fehlschlägt. Sichere Datenbank, Uploads und Konfiguration vor jedem Update.

1. Was gesichert werden muss

  • Die MariaDB oder MySQL Datenbank.
  • public/shared/uploads/, weil dort Nutzeruploads und zwischengespeicherte entfernte Avatare liegen.
  • Bei Docker deploy/.env.
  • Bei normalen Installationen config.php.
  • Eigene Stylesets, Templates oder lokale Änderungen.

2. Docker Update

Führe diese Befehle zuerst aus dem APBoard Repository und dann aus deploy/ aus. Ersetze den Pfad durch deinen Installationspfad.

bash 
cd /home/apboard/forum/deploy
docker compose exec db mariadb-dump -u root -p"$APBOARD_DB_ROOT_PASSWORD" "$APBOARD_DB_NAME" > apboard-backup.sql

cd /home/apboard/forum
git pull

cd deploy
docker compose up -d --build --remove-orphans
docker compose ps

Der App Container startet mit dem aktuellen Code. Er erstellt Asset Links neu, aktualisiert bei Bedarf Composer Pakete und schreibt config.php aus .env. APBoard prüft update/migrations/ beim normalen Start der Anwendung und speichert ausgeführte Migrationen in der Tabelle apb_migrations.

3. Update auf normalem Webserver

Lade das neue Release ZIP herunter, entpacke es in ein temporäres Verzeichnis und kopiere es über die bestehende Installation. Behalte deine vorhandene config.php und deine Uploads.

bash 
mysqldump -u apboard -p apboard > apboard-backup.sql
cp /var/www/apboard/config.php ./config.php.backup
tar -czf uploads-backup.tar.gz -C /var/www/apboard public/shared/uploads

cd /tmp
unzip apboard-v3-new.zip -d apboard-new

sudo rsync -av \
  --exclude='config.php' \
  --exclude='public/shared/uploads/' \
  /tmp/apboard-new/ /var/www/apboard/

sudo chown -R www-data:www-data /var/www/apboard

Öffne danach das Forum im Browser. APBoard führt ausstehende Migrationen beim Start aus. APBoard hat keinen artisan Befehl.

4. Nach dem Update prüfen

  • Startseite öffnen.
  • Als Administrator anmelden.
  • Ein Board, ein Thema und den Admin Bereich öffnen.
  • Wenn möglich einen Testbeitrag erstellen.
  • Webserver Logs oder Docker Logs auf Fehler prüfen.

5. Wenn etwas schiefgeht

Stoppe zuerst und sichere die Hinweise. Kopiere die genaue Fehlermeldung, die APBoard Version oder den Git Commit, und die letzten Logzeilen. Stelle Datei und Datenbankbackup nur wieder her, wenn du wirklich auf die alte Version zurück musst.

bash 
# Docker Logs
cd /home/apboard/forum/deploy
docker compose logs --tail 200 app
docker compose logs --tail 200 db

# Apache Logs auf einem normalen Server
sudo tail -200 /var/log/apache2/apboard_error.log
Zurück Nach der Installation Weiter Fehlerbehebung