Für Betreiber, die keinen Docker einsetzen möchten: QuickTribe läuft auch direkt auf einem Linux-Server mit nginx und PHP-FPM. Composer, Node.js oder ein Build-Schritt sind nicht nötig – das Webserver-Archiv enthält die fertige Anwendung samt PHP-Abhängigkeiten und gebauter Oberfläche. Sie brauchen Root-Zugriff auf einen eigenen Server (VPS oder dedizierter Server). Shared Hosting genügt nicht: Die Plattform braucht dauerhaft laufende Prozesse (Worker, Echtzeit-Hub) und Redis.
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 Archiv quicktribe-vX.Y.Z-webserver.tar.gz und seine Prüfsumme. Beide auf den Server kopieren und prüfen:
Das Archiv enthält den Code, die PHP-Abhängigkeiten (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:
Benötigt werden die PHP-Erweiterungen 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:
MariaDB lauscht unter Debian nur lokal; das bleibt so.

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 unter releases/; 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:
Die Shell setzt beim Anlegen Zufallswerte ein und – in derselben Sitzung – 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_SECRET nach dem ersten Start nie ändern – daraus werden Geheimnisse verschlüsselt.
  • MAILER_DSN/MAILER_FROM_ADDRESS sind optional: Lässt man MAILER_DSN leer, 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).
  • localhost in DATABASE_URL verbindet über den Unix-Socket von MariaDB. serverVersion an 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_PATH wird hier nicht gebraucht.
  • APP_PLUGINS_DIR zeigt auf shared/plugins, damit Plugins Updates der Plattform überdauern. Ohne die Zeile sucht QuickTribe Plugins im Ordner plugins/ 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:
Pool /etc/php/8.5/fpm/pool.d/quicktribe.conf:

9. Datenbank, Cache und erstes Konto

Alle Konsolenbefehle laufen im Anwendungsverzeichnis als www-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:
Dann die Site anlegen – /etc/nginx/sites-available/quicktribe:
Die Konfiguration entspricht der des Docker-Images: Upload-Grenze 105 MB, für die Video-Route 2 GB; das PWA-Manifest kommt aus der Anwendung, der Service Worker 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:
Aufträge von Erweiterungen (Plugins: Hintergrund-Jobs, Aufgaben, Reaktionen auf Ereignisse) arbeitet ein zweiter Dienst mit eigener Warteschlange ab – so hält ein langer Auftrag einer Erweiterung keine E-Mails oder Erinnerungen auf. /etc/systemd/system/quicktribe-plugin-worker.service:
Es läuft genau ein 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

Dann im Browser 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.
Der Wartungsmodus zeigt während der Migration allen Besuchern die Zugangsseite; Geräte, die das Zugangswort kennen, kommen weiter durch. War die Plattform ohnehin im Wartungsmodus, den letzten Befehl weglassen. Plugins liegen in 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:
Das genügt, solange das Update keine Datenbank-Migrationen ausgeführt hat (Ausgabe von 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).