Die Anleitung ist mit Debian 13 „trixie“ durchgespielt (frisches System, alle Befehle wie unten). Andere Distributionen funktionieren mit denselben Bausteinen, Paketnamen und Pfade weichen ab. Unter Ubuntu 24.04 kommt PHP 8.5 aus dem PPA
ppa:ondrej/php; die dort enthaltene MariaDB 10.11 ist zu alt, MariaDB 11.4 oder neuer liefert das Paket-Repository von mariadb.org.Bausteine
Hardware wie unter Systemvoraussetzungen. Dazu kommen eine Domain, deren DNS-Eintrag auf den Server zeigt, offene Ports 80 und 443 und ein SMTP-Zugang (siehe Konfiguration; er lässt sich auch nach dem ersten Login im Plattform-Admin unter E-Mail-Versand eintragen).
1. Webserver-Archiv prüfen
Mit jedem Release erhalten Sie neben dem Auslieferungspaket für Docker das Archivquicktribe-vX.Y.Z-webserver.tar.gz und seine Prüfsumme. Beide auf den Server kopieren und prüfen:
vendor/), die gebaute Oberfläche (public/build/) und die mitgelieferten Themes. Geheimnisse enthält es keine; die Datei .env darin hat nur unkritische Standardwerte.
2. Pakete installieren
Debian 13 enthält PHP 8.4. PHP 8.5 kommt aus der Paketquelle packages.sury.org von Ondřej Surý, der auch die PHP-Pakete in Debian betreut:intl, pdo_mysql, zip, gd (mit JPEG, WebP und FreeType), bcmath, redis, curl, mbstring, xml (mit dom, u. a. für die PDF-Tickets), sodium, pcntl und OPcache; die Pakete oben bringen sie alle mit (php -m zeigt sie an). Für Plugins braucht QuickTribe außerdem das Kommandozeilenprogramm php (Paket php8.5-cli, prüft neue Plugin-Fassungen in einem eigenen Prozess) und openssl (Zeitstempel, kommt mit ca-certificates); PHP darf dafür Prozesse starten (proc_open nicht in disable_functions).
3. MariaDB
Zeichensatz wie im Docker-Stack, dann Datenbank und Benutzer anlegen:4. Redis
Redis lauscht unter Debian nur lokal (127.0.0.1). Damit die Warteschlange einen Neustart übersteht, das Append-Only-File einschalten:
5. Mercure (Echtzeit)
Der Hub kommt als Paket von den Mercure-Releases (Version 0.24.2 wie im Docker-Stack) und lauscht nur lokal auf Port 3000; nginx leitet/.well-known/mercure an ihn weiter.
/etc/mercure/Caddyfile:
/etc/systemd/system/mercure.service:
MERCURE_JWT_SECRET muss in /etc/mercure/mercure.env und in der Konfiguration der Anwendung (Schritt 7) gleich sein.
6. Anwendung entpacken
Jede Version bekommt ein eigenes Verzeichnis unterreleases/; der Link current zeigt auf die laufende. Was Versionen überdauert – Konfiguration und Uploads (darin auch hochgeladene Themes) – liegt unter shared/. So sind Updates und ein Rücksprung jeweils nur ein Umschalten des Links.
7. Konfiguration
Die Anwendung liest ihre Einstellungen aus.env.local im Anwendungsverzeichnis (hier ein Link auf shared/.env.local); Werte darin überschreiben die Standardwerte aus .env. Alle Variablen erklärt die Konfiguration. Für den Webserver-Betrieb:
DB_PASSWORD und MERCURE_JWT_SECRET aus Schritt 3 und 5; in einer neuen Sitzung die notierten Werte von Hand eintragen. Danach die Datei mit einem Editor ergänzen (SMTP-Zugang, später Stripe, Push, Google-Login). Hinweise:
APP_SECRETnach dem ersten Start nie ändern – daraus werden Geheimnisse verschlüsselt.MAILER_DSN/MAILER_FROM_ADDRESSsind optional: Lässt manMAILER_DSNleer, richtet der Plattform-Admin den SMTP-Zugang unter E-Mail-Versand ein (siehe Konfiguration → E-Mail).- Werte mit
&, Leerzeichen oder#in Anführungszeichen setzen; Sonderzeichen in Passwörtern innerhalb von URLs URL-kodieren (@→%40). localhostinDATABASE_URLverbindet über den Unix-Socket von MariaDB.serverVersionan die installierte Version anpassen (mariadb --version).TRUSTED_PROXIES=127.0.0.1: nginx spricht direkt mit den Besuchern, es gibt keinen weiteren Proxy. Steht doch einer davor (z. B. ein Load Balancer), dessen Adresse ergänzen (siehe Proxys und Besucher-IP).- Die Sitzungen in Redis stellt PHP selbst ein (Schritt 8,
session.save_path);REDIS_SESSION_SAVE_PATHwird hier nicht gebraucht. APP_PLUGINS_DIRzeigt aufshared/plugins, damit Plugins Updates der Plattform überdauern. Ohne die Zeile sucht QuickTribe Plugins im Ordnerplugins/der jeweiligen Version.- Variablen, die nur die Docker-Varianten betreffen (
APP_IMAGE,MARIADB_*,APP_PORT,APP_BIND,TRAEFIK_*,COMPOSE_PROJECT_NAME), entfallen.
8. PHP und PHP-FPM
Die Einstellungen entsprechen denen des Docker-Images./etc/php/8.5/mods-available/quicktribe.ini:
/etc/php/8.5/fpm/pool.d/quicktribe.conf:
9. Datenbank, Cache und erstes Konto
Alle Konsolenbefehle laufen im Anwendungsverzeichnis alswww-data:
app:install legt aus ADMIN_EMAIL/ADMIN_PASSWORD das erste Konto (Plattform-Admin) an und schaltet den Wartungsmodus ein; die Ausgabe nennt das Zugangswort (Zeile Zugangswort: …). Danach darf ADMIN_PASSWORD aus .env.local entfernt werden.
Zeilen mit
User Deprecated in der Ausgabe der Konsolenbefehle sind Hinweise für künftige Versionen der verwendeten Bibliotheken, keine Fehler.10. nginx und TLS
Zuerst das Zertifikat holen. Solange die Standard-Site von Debian aktiv ist, beantwortet nginx auf Port 80 die Prüfung von Let’s Encrypt aus/var/www/html:
/etc/nginx/sites-available/quicktribe:
sw.js ohne Cache; die gebauten Dateien der Plugins liefert nginx unter /plugin-assets/ direkt aus shared/plugins (der Pfad im alias muss zu APP_PLUGINS_DIR passen), Seiten von Plugins unter /plugins/… laufen wie alles andere über PHP; außer index.php wird keine PHP-Datei ausgeführt; den Echtzeit-Hub erreicht der Browser unter derselben Adresse. Die Sicherheits-Header (CSP, HSTS …) für Seiten setzt die Anwendung selbst. certbot erneuert das Zertifikat automatisch (systemctl list-timers certbot.timer) und lädt nginx danach neu.
Endet TLS nicht in diesem nginx, sondern in einem vorgelagerten Proxy, entfällt der server-Block für Port 443: Der Block auf Port 80 bekommt dann die Inhalte (ohne ssl_*), in der .env.local stehen die Adresse des Proxys in TRUSTED_PROXIES und – falls er kein X-Forwarded-Proto sendet – APP_TLS_TERMINATED=1.
11. Worker
Der Worker arbeitet die Warteschlangen und die Zeitpläne ab (u. a. E-Mails, Erinnerungen, Ablauf von Plänen)./etc/systemd/system/quicktribe-worker.service:
/etc/systemd/system/quicktribe-plugin-worker.service:
quicktribe-worker: Er führt auch die zeitgesteuerten Aufgaben aus, die sonst doppelt liefen; vom Plugin-Worker genügt ebenfalls einer. Beide Dienste beenden sich planmäßig nach einer Stunde (oder bei 512 MB Speicher) und starten sofort neu – das ist gewollt. Beim Anhalten beendet jeder Dienst erst seinen laufenden Auftrag; TimeoutStopSec=300 gibt ihm dafür bis zu fünf Minuten, systemctl stop und restart können also etwas dauern. Nach dem Einspielen oder Aktualisieren einer Erweiterung beide neu starten und PHP neu laden (systemctl restart quicktribe-worker quicktribe-plugin-worker, systemctl reload php8.5-fpm).
12. Prüfen und freigeben
https://community.example.org öffnen, das Zugangswort eingeben, mit ADMIN_EMAIL/ADMIN_PASSWORD anmelden und unter /admin den Systemstatus prüfen. Den Mailversand prüft runuser -u www-data -- php bin/console app:mail:test <email>. Unter Plattform-Admin → Wartung geben Sie die Plattform frei, sobald sie öffentlich sein soll (siehe Wartung). Ein eigenes Erscheinungsbild richten Sie mit einem Theme ein.
Betrieb
Nach jeder Änderung an
.env.local: systemctl reload php8.5-fpm und systemctl restart quicktribe-worker quicktribe-plugin-worker.
Datensicherung Die Datensicherung erfolgt außerhalb der Anwendung durch den Betreiber. Relevant sind die Datenbank
community, das Verzeichnis shared/uploads und die Datei shared/.env.local (ohne das darin stehende APP_SECRET lassen sich verschlüsselte Einstellungen nicht mehr lesen).Updates
Ein Update ist eine neue Version neben der alten; umgeschaltet wird erst, wenn alles vorbereitet ist.shared/plugins und bleiben erhalten; prüfen Sie vor dem Update, ob sie zur neuen Version passen (siehe Plugins betreiben → Update der Plattform). systemctl reload php8.5-fpm ist nötig, weil OPcache den Code ohne Neustart nicht neu liest. Alte Versionen unter releases/ können nach einigen Tagen gelöscht werden.
Hinweise zu einzelnen Versionen (neue Variablen, Änderungen an der nginx-Konfiguration) stehen unter Updates → Hinweise zu einzelnen Versionen, unter Änderungen und in den Release-Informationen; Änderungen an der nginx- bzw. PHP-Konfiguration des Images in die eigene Konfiguration übernehmen. Steht in .env.local noch APP_TEMPLATES, kann die Zeile entfallen – die Variable ist seit 1.7.3 ohne Wirkung.
Rücksprung
Auf die vorige Version zurückschalten:doctrine:migrations:migrate: „Already at the latest version“). Hat es welche ausgeführt, ist der Rücksprung nur zusammen mit einer Datensicherung der Datenbank von vor dem Update möglich – wie bei den Docker-Varianten (siehe Updates).