Flarum auf einem VPS mit PHP installieren
Installieren Sie Flarum 1.x mit PHP, Composer und MariaDB, veröffentlichen Sie nur /public per TLS und beheben Sie Mail- sowie Extension-Upgrade-Fallen.
Flarum auf einem VPS mit PHP und MariaDB installieren
Wenn Sie Flarum auf einem VPS installieren, erhalten Sie ein Forum auf Basis von PHP und MariaDB – ohne Docker, ohne Ruby und ohne separaten Job-Runner. Das ist der Grund, sich dafür zu entscheiden. Discourse auf einem VPS installieren bedeutet einen Docker-Stack mit Ruby, PostgreSQL, Redis und einem Hintergrund-Worker. Discourse empfiehlt in der eigenen Installationsanleitung 2 GB RAM; 1 GB funktioniert nur mit Swap, bevor Sie Backups oder einen Maildienst hinzufügen. Discourse rechtfertigt diesen Ressourcenbedarf in einer stark frequentierten Community mit Tausenden Beiträgen pro Tag. In einem Forum mit einigen hundert Nutzern ist es zusätzliche Infrastruktur, für die Sie jeden Monat bezahlen, die Sie aber nie auslasten. Flarum passt in einen PHP-Stack, den Sie möglicherweise bereits betreiben. Daher kann ein VPS mit 1 GB RAM, nginx und MariaDB Flarum neben den bereits vorhandenen Diensten hosten. Wenn die Entscheidung noch offen ist, behandelt der umfassendere Vergleich selbst gehosteter Forensoftware die übrigen Optionen.
Diese Anleitung verwendet Flarum 1.x, derzeit aus der 1.8-Serie. Flarum 2.0.0 wurde am 9. Oktober 2026 als stabile Version veröffentlicht. Am 12. Oktober 2026 weist die eigene Upgrade-Anleitung von Flarum jedoch darauf hin, dass viele Erweiterungen bisher nur Beta-Releases für 2.0 veröffentlicht haben. Außerdem erhält die 1.x-Reihe weiterhin Fehlerbehebungen für kritische Fehler und Sicherheitsprobleme. Die Erweiterungen sind hier wichtiger als die Core-Version. Daher ist 1.8 für ein Forum, das von diesen Erweiterungen abhängt, weiterhin die sicherere Version. Wenn Sie keine Erweiterungen von Drittanbietern benötigen, ist 2.0 die aktuelle Version. Sie benötigt PHP 8.3 oder neuer, das Ubuntu 24.04 mitliefert. In der Flarum-Dokumentation wird die Installation mit composer create-project flarum/flarum:^2.0.0 . beschrieben. Die folgenden Befehle sind für 1.8 ausgelegt.
Was Flarum 1.8 auf dem Server benötigt
Die dokumentierten Anforderungen von Flarum sind PHP 7.3 oder neuer, MySQL 5.6+ oder MariaDB 10.0.5+ sowie entweder nginx oder Apache mit mod_rewrite. Ubuntu 24.04 wird mit PHP 8.3 und MariaDB 10.11 ausgeliefert. Die Distributionspakete erfüllen daher beide Anforderungen ohne ein Drittanbieter-Repository. Flarum 2.0 setzt PHP 8.3+, MySQL 5.7+ / 8.0.30+ oder MariaDB 10.3+ voraus. Auch diese Anforderungen erfüllen die Ubuntu-Pakete. Flarum benötigt die PHP-Erweiterungen curl, dom, fileinfo, gd, json, mbstring, openssl, pdo_mysql, tokenizer und zip. Außerdem benötigen Sie Shell-Zugriff, weil Composer hier zwingend erforderlich ist: Jede Flarum-Erweiterung ist ein Composer-Paket. Ohne Composer kann keine Erweiterung hinzugefügt werden.
Flarum ist eine gewöhnliche PHP-Anwendung. Wenn Sie bereits einen LAMP-Stack auf Ubuntu 24.04 betreiben, ist der größte Teil der nächsten beiden Abschnitte bereits installiert. Sie können daher bis zum Datenbankabschnitt übergehen.
PHP und die von Flarum benötigten Erweiterungen installieren
sudo apt update
sudo apt install -y nginx mariadb-server composer
sudo apt install -y php8.3-fpm php8.3-cli php8.3-curl php8.3-gd php8.3-mbstring php8.3-mysql php8.3-xml php8.3-zip
php -m | grep -E 'curl|dom|gd|mbstring|pdo_mysql|zip'
composer --versionDie Paketnamen entsprechen nicht eins zu eins der Liste von Flarum. Die Erweiterung dom ist in php8.3-xml enthalten. fileinfo, json, openssl und tokenizer sind entweder in PHP 8.3 unter Ubuntu integriert oder Bestandteil von php8.3-common, das von den Paketen oben als Abhängigkeit installiert wird. Für diese Erweiterungen müssen Sie daher nichts zusätzlich installieren. grep sollte sieben Zeilen ausgeben: die sechs Erweiterungen sowie random, ein Modul, das PHP 8.3 immer lädt und dessen Name zufällig dom enthält. composer --version sollte eine Version aus der Reihe 2.x melden. Eine fehlende Erweiterung sollten Sie jetzt beheben. Wenn beispielsweise php8.3-xml fehlt, verweigert Composer die Installation von Flarum vollständig, weil eine der Abhängigkeiten ext-dom deklariert. Die Fehlermeldung nennt die benötigte Erweiterung. Entscheidend ist das Ende der folgenden Zeile:
require ext-dom * -> it is missing from your system. Install or enable PHP's dom extension.Composer prüft allerdings nicht jede Erweiterung aus der Flarum-Liste. Die von Flarum 1.8 verwendete Bildbibliothek empfiehlt lediglich gd. Ein Server ohne diese Erweiterung installiert Flarum daher problemlos und schlägt erst später fehl, wenn Flarum erstmals einen hochgeladenen Avatar oder ein Logo verarbeiten muss.
Prüfen Sie, ob PHP auf der Befehlszeile und der FastCGI-Prozessmanager (PHP-FPM) dieselbe Version verwenden. Composer wird über die Befehlszeilen-Binärdatei ausgeführt, während Ihr Forum unter FPM läuft. Daher müssen php -v und sudo php-fpm8.3 -v übereinstimmen. Auf einem System, auf dem sich mehrere PHP-Versionen aus einem Drittanbieter-Repository angesammelt haben, können sie auseinanderlaufen. Dann ist eine für die eine Version installierte Erweiterung für die andere nicht sichtbar.
Datenbank und dedizierten Datenbankbenutzer erstellen
sudo mariadb-secure-installation
sudo mariadbCREATE DATABASE flarum CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'flarum'@'localhost' IDENTIFIED BY 'use-a-long-random-password';
GRANT ALL PRIVILEGES ON flarum.* TO 'flarum'@'localhost';
FLUSH PRIVILEGES;
EXIT;Verwenden Sie für Flarum einen eigenen Datenbankbenutzer statt root. Die Berechtigung umfasst flarum.* und nichts anderes. Dadurch kann eine SQL-Injection-Schwachstelle in einer Erweiterung, die Sie nicht selbst geschrieben haben, Ihre anderen Datenbanken nicht lesen. Auch der Zeichensatz ist wichtig: utf8mb4 speichert Emojis und nichtlateinische Schriften korrekt, während das ältere MySQL-Format utf8 eine Drei-Byte-Kodierung verwendet und einen Beitrag beim ersten Vier-Byte-Zeichen abschneidet. Prüfen Sie, ob der Benutzer funktioniert, bevor Sie fortfahren.
mariadb -u flarum -p flarum -e 'SELECT DATABASE();'Die Ausgabe sollte flarum lauten. ERROR 1045 (28000): Access denied for user 'flarum'@'localhost' bedeutet, dass das Passwort nicht übereinstimmt oder der Benutzer für einen anderen Host als localhost angelegt wurde.
Flarum auf einem VPS mit Composer installieren und auf 1.8 festlegen
Erstellen Sie zunächst einen Systembenutzer, dem der Code gehört. Wenn Sie Composer als root ausführen, bleiben Dateien in vendor/ und storage/ im Besitz von root. PHP kann seinen eigenen Cache später dann nicht schreiben, und das Forum beantwortet jede Anfrage mit einem 500-Fehler.
sudo useradd --system --home-dir /srv/flarum --shell /bin/bash flarum
sudo install -d -o flarum -g flarum -m 755 /srv/flarum
sudo -iu flarumDer letzte Befehl öffnet eine Shell als Benutzer flarum im Verzeichnis /srv/flarum. Jeder Befehl bis zum Ende der Anleitung wird dort ausgeführt, sofern er nicht mit sudo beginnt.
composer create-project flarum/flarum:^1.8.0 .Die Einschränkung ^1.8.0 legt die Version fest. Sie akzeptiert Patch-Releases der Version 1.8.x und lehnt 2.0 ab. Das ist wichtig, da 2.0.0 jetzt die stabile Version ist: Ohne diese Einschränkung installiert composer create-project Version 2.0. Composer lädt das Grundgerüst herunter, löst flarum/core und dessen Abhängigkeiten auf und hinterlässt public/, storage/, vendor/, composer.json sowie ein flarum-Befehlszeilenskript.
Auf einem kleinen VPS treten Fehler häufig an dieser Stelle auf, und zwei unterschiedliche Fehler sehen ähnlich aus. PHP Fatal error: Allowed memory size of 134217728 bytes exhausted ist das eigene memory_limit von PHP. Wenn Sie COMPOSER_MEMORY_LIMIT=-1 vor den Befehl setzen, wird diese Begrenzung für einen einzelnen Lauf aufgehoben. Ein alleinstehendes Killed in einer eigenen Zeile ohne PHP-Fehler stammt vom Out-of-Memory-Killer des Kernels. Das können Sie mit dmesg | tail bestätigen. In diesem Fall ist der Arbeitsspeicher tatsächlich erschöpft. Fügen Sie daher Swap hinzu. Wenn Sie das PHP-Limit erhöhen, verschlimmern Sie das Problem, weil PHP dann noch mehr Speicher anfordert, bevor der Kernel eingreift.
Warum nur /public aus dem Web erreichbar sein sollte
Das Projektverzeichnis enthält config.php mit Ihrem Datenbankpasswort im Klartext, vendor/ mit sämtlichen Abhängigkeiten und storage/ mit Logs und zwischengespeicherten Sitzungen. Nichts davon gehört ins öffentliche Internet. Flarum hält alle aus dem Web erreichbaren Dateien in einem Unterverzeichnis, public/. Dieses enthält index.php, einen Ordner assets/ und wenig mehr. Setzen Sie den Webserver-Root auf /srv/flarum/public. Damit ist der restliche Verzeichnisbaum konstruktionsbedingt nicht über HTTP erreichbar, statt von einer Regel abzuhängen, an die Sie sich erinnern müssen.
Setzen Sie den Root stattdessen auf /srv/flarum, sind die Folgen erheblich. Eine Anfrage an /config.php liefert nichts Verwertbares, weil PHP die Datei ausführt und sie lediglich ein Array zurückgibt. /storage/logs/flarum.log liefert einem Fremden jedoch Ihre Stacktraces und Datenbankfehler, und /composer.lock verrät die genaue Version jedes von Ihnen eingesetzten Pakets. Damit erhält er eine Liste bekannter Schwachstellen, die er ausprobieren kann.
PHP-FPM einen eigenen Pool zuweisen
Flarum benötigt Schreibzugriff auf drei Pfade: auf das Projektverzeichnis, damit der Installer config.php erstellen kann; auf storage/ für Logs und den Cache; sowie auf assets/ für hochgeladene Avatare und Logos. Die Dateien gehören dem Benutzer flarum. Daher ist ein eigener PHP-FPM-Pool die saubere Lösung, der als flarum ausgeführt wird. nginx läuft weiterhin als www-data und liest ausschließlich.
Schreiben Sie /etc/php/8.3/fpm/pool.d/flarum.conf:
[flarum]
user = flarum
group = flarum
listen = /run/php/php8.3-fpm-flarum.sock
listen.owner = www-data
listen.group = www-data
listen.mode = 0660
pm = ondemand
pm.max_children = 10
pm.process_idle_timeout = 30s
php_admin_value[memory_limit] = 256M
php_admin_value[upload_max_filesize] = 16M
php_admin_value[post_max_size] = 17Msudo systemctl restart php8.3-fpm
ls -l /run/php/php8.3-fpm-flarum.sockDer Socket muss als srw-rw---- 1 www-data www-data aufgeführt sein. Der Master-Prozess läuft als root und erstellt den Socket. Deshalb kann er den Besitz an www-data übergeben, während die Worker als flarum laufen. Wenn der Socket nicht vorhanden ist, gibt sudo journalctl -u php8.3-fpm -n 30 die Zeile FPM rejected aus. pm = ondemand startet Worker-Prozesse erst, wenn eine Anfrage eingeht. Ein wenig besuchtes Forum benötigt daher zwischen den Zugriffen nahezu keinen Speicher.
Der nginx-Serverblock
Flarum liefert im Projektstamm eine nginx-Snippet-Datei namens .nginx.conf mit. Sie enthält die Rewrite-Regel, die Cache-Header und die Komprimierungseinstellungen. Binden Sie sie ein, statt ihren Inhalt zu kopieren. Dadurch erreicht ein Flarum-Upgrade, das das Snippet ändert, Ihren Server, ohne dass Sie etwas bearbeiten müssen.
server {
listen 80;
listen [::]:80;
server_name forum.example.com;
root /srv/flarum/public;
index index.php;
client_max_body_size 16M;
include /srv/flarum/.nginx.conf;
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.3-fpm-flarum.sock;
}
}Speichern Sie die Datei als /etc/nginx/sites-available/flarum und aktivieren Sie sie anschließend.
sudo ln -s /etc/nginx/sites-available/flarum /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginxnginx -t sollte auf syntax is ok und test is successful antworten. Die Zeile include wird häufig weggelassen. Das führt zu einem ganz bestimmten Fehlerbild: Die Startseite wird vollständig geladen, aber jeder Link zu einer Diskussion liefert von nginx einen 404-Fehler. Flarum verarbeitet eine URL wie /d/1-hello-world innerhalb von PHP. Dieser Pfad ist keine Datei auf dem Datenträger. Ohne die try_files $uri $uri/ /index.php?$query_string-Regel des Snippets sucht nginx daher nach einem Verzeichnis namens d, findet es nicht und liefert den 404-Fehler, bevor PHP überhaupt aufgerufen wird. Apache verwendet dieselbe Weiterleitung aus der Datei .htaccess, die bereits in public/ liegt. Sie wird jedoch nur wirksam, wenn der passende <Directory>-Block AllowOverride All setzt.
TLS einrichten, bevor Sie das Installationsprogramm ausführen
Richten Sie das Zertifikat jetzt ein, nicht nachträglich. Flarum schreibt während der Installation seine Basis-URL in config.php und übernimmt diese URL aus der Adresse in Ihrem Browser. Wenn Sie Flarum über http:// installieren, beginnt jede von Flarum anschließend erzeugte Asset-URL mit http://. Sobald Sie TLS (Transport Layer Security) hinzufügen, blockiert der Browser diese Anfragen als gemischte Inhalte. Das Forum wird dann als unformatierter Text ohne JavaScript geladen. Arbeiten Sie zuerst die Certbot-Einrichtung für Let's Encrypt unter nginx durch. Bestätigen Sie, dass https://forum.example.com eine Seite bereitstellt, und kehren Sie anschließend hierher zurück.
Wenn Sie die Installation bereits über reines HTTP ausgeführt haben, besteht die Reparatur aus einer Zeile. Bearbeiten Sie /srv/flarum/config.php so, dass der Schlüssel url den Wert 'url' => 'https://forum.example.com', enthält. Führen Sie anschließend php flarum cache:clear als Benutzer flarum aus.
Installer ausführen und config.php absichern
Öffnen Sie https://forum.example.com in einem Browser. Der Webinstaller von Flarum fragt nach dem Datenbanknamen, dem von Ihnen erstellten Datenbankbenutzer und dessen Passwort, dem Forentitel sowie Ihrem Administratorkonto. Er schreibt config.php und erstellt die Tabellen. Sichern Sie nach Abschluss die Datei ab, die nun Ihr Datenbankpasswort enthält.
sudo chmod 640 /srv/flarum/config.phpDie Datei bleibt für flarum lesbar und beschreibbar. Dabei handelt es sich um den Benutzer, unter dem FPM ausgeführt wird. Für alle anderen Konten auf dem Server ist sie nicht lesbar. Prüfen Sie anschließend die Installation über die Shell.
php flarum infoDie Ausgabe enthält die Core-Version, die PHP-Version, die aktivierten Erweiterungen, den Mail-Treiber und die verwendeten Pfade. Dieser Befehl ist der erste Schritt, wenn sich etwas fehlerhaft verhält. Er ist auch das Erste, wonach eine Person fragt, die Sie bei der Fehlersuche unterstützt.
Warum E-Mails zur Registrierung und zum Zurücksetzen des Passworts unbemerkt fehlschlagen
Dieser Abschnitt entscheidet, ob Ihr Forum die erste Woche übersteht. Die ersten beiden E-Mails, die ein neues Forum versendet, sind die Registrierungsbestätigung und die E-Mail zum Zurücksetzen des Passworts. Beide werden genau in dem Moment versendet, in dem ein Fremder entscheidet, ob Ihre Community seriös ist. Beide schlagen unbemerkt fehl. Die Person, die die E-Mail nie erhalten hat, kann Sie nicht darüber informieren, und auf Ihrem Administrations-Dashboard wird kein Fehler angezeigt.
Flarum verfügt über vier Mail-Treiber, die Sie unter Administration und anschließend Email konfigurieren: smtp, mail, mailgun und log. Wählen Sie smtp und konfigurieren Sie ihn für einen Mail-Dienst, der Nachrichten tatsächlich zustellt. Der Treiber mail übergibt die Nachricht an eine lokale sendmail-Binärdatei. Diese ist auf einem frisch installierten Ubuntu-VPS nicht vorhanden. Deshalb wird die Nachricht nirgendwohin zugestellt, ohne dass ein Fehler ausgelöst wird. Der Treiber log schreibt den Nachrichteninhalt in storage/logs/ und versendet überhaupt nichts, weil er für die Entwicklung vorgesehen ist.
Speichern Sie die Einstellungen. Klicken Sie anschließend auf derselben Seite auf die Schaltfläche Send Test Mail. Diese Schaltfläche ist die einzige Rückmeldung, die Sie erhalten. Verwenden Sie sie daher, bevor Sie jemanden einladen. Wenn die Nachricht nicht ankommt, lesen Sie das Log.
tail -n 50 /srv/flarum/storage/logs/flarum.logEine abgelehnte Verbindung, eine zurückgewiesene Anmeldung und ein fehlgeschlagener TLS-Verbindungsaufbau werden dort jeweils mit dem verwendeten Host und Port protokolliert. Eine Zeile mit Connection could not be established with host smtp.example.com bedeutet, dass der Port blockiert oder falsch ist. Die häufigste Ursache ist, dass der Anbieter ausgehende Verbindungen über Port 25 standardmäßig blockiert. Port 587 mit dem Verschlüsselungsfeld auf tls gesetzt funktioniert mit nahezu jedem Mail-Dienst.
Wenn der Mailversand nicht funktioniert, sieht ein Besucher nach der Registrierung das allgemeine Flarum-Fehlerbanner Oops! Something went wrong. Please reload the page and try again., weil beim Versand der Bestätigung ein Fehler auftritt. In beiden Fällen kann sich diese Person nicht anmelden und wird Sie deshalb auch nicht darüber informieren.
Dass eine E-Mail angenommen wird, ist ein anderes Problem als ihr Versand. Eine E-Mail von einer VPS-Adresse ohne veröffentlichte SPF- oder DKIM-Einträge für Ihre Domain landet im Spam-Ordner oder wird ohne jegliche Bounce-Nachricht verworfen. Ihr Log zeigt dann einen erfolgreichen Versand, während der Empfänger die Nachricht weiterhin nicht sieht. E-Mails zuverlässig aus selbst gehosteten Anwendungen versenden beschreibt, welche DNS-Einträge Sie veröffentlichen sollten und welche Relay-Dienste empfehlenswert sind.
Erweiterungen sind Composer-Pakete. Aktualisierungen erfolgen daher über einen Befehl.
In Flarum ist eine Erweiterung ein Composer-Paket. Es gibt keine Upload-Schaltfläche und keine ZIP-Datei, die Sie in ein Verzeichnis kopieren. Das ist eine bewusste Designentscheidung: Versionen werden aufeinander abgestimmt, die genaue Paketmenge wird in composer.lock festgehalten, und eine Erweiterung, die von einer PHP-Bibliothek abhängt, installiert diese Bibliothek korrekt. Der Nachteil ist, dass das Hinzufügen als Benutzer flarum drei Befehle erfordert.
composer require 'fof/upload:*'
php flarum migrate
php flarum cache:clearAktivieren Sie die Erweiterung anschließend unter Administration und Extensions. Jeder Befehl hat eine eigene Aufgabe. composer require legt den Code auf dem Datenträger ab. php flarum migrate führt die Datenbankmigrationen der Erweiterung aus. Dadurch werden die benötigten Tabellen erstellt. php flarum cache:clear erstellt die kompilierten JavaScript- und CSS-Bundles neu, die der Browser lädt. Wenn Sie den letzten Befehl überspringen, entsteht die typische Verwirrung: Die Erweiterung wird angezeigt, der Schalter ist aktiviert, und im Browser ändert sich trotz beliebig vieler Neuladungen überhaupt nichts.
Beim Entfernen einer Erweiterung gehen Sie in umgekehrter Reihenfolge vor. Deaktivieren Sie sie zuerst im Administrationsbereich und entfernen Sie anschließend das Paket. Flarum lässt die Tabellen der Erweiterung absichtlich bestehen. Wenn Sie die Erweiterung später wieder aktivieren, gehen dadurch keine Daten verloren. Wenn Sie die Tabellen ebenfalls löschen möchten, setzen Sie die Migrationen zurück, bevor Sie den Code entfernen.
php flarum migrate:reset --extension fof-upload
composer remove fof/upload
php flarum cache:clearDie Erweiterungs-ID in diesem Befehl ist der Paketname, bei dem der Schrägstrich durch einen Bindestrich ersetzt wurde. Wenn Sie lieber klicken als tippen, fügt composer require 'flarum/extension-manager:*' eine offizielle Administrationsseite hinzu, die Composer kapselt. Sie führt dieselben Vorgänge wie der Webbenutzer aus, benötigt denselben Arbeitsspeicher und dieselben Schreibberechtigungen und schlägt aus denselben Gründen fehl. Wenn ein Problem auftritt, bleibt die Befehlszeile daher der zuverlässige Weg.
Warum composer update ein Upgrade von Flarum verweigert
Das Upgrade von Flarum und allen Erweiterungen besteht aus einem Composer-Befehl und anschließend zwei Flarum-Befehlen. Sichern Sie zuerst die Datenbank.
composer update --prefer-dist --no-plugins --no-dev -a --with-all-dependencies
php flarum migrate
php flarum cache:clearLesen Sie die Ausgabe, statt einfach von einem erfolgreichen Vorgang auszugehen. Der relevante Fall tritt ein, wenn Composer jede Änderung ablehnt:
Your requirements could not be resolved to an installable set of packages.Diese Meldung bedeutet, dass eine installierte Erweiterung eine flarum/core-Bedingung festlegt, die die Version ausschließt, auf die Sie aktualisieren. Composer verletzt diese Bedingung nicht. Daher belässt er die gesamte Installation auf der alten Version, statt eine Kombination zusammenzustellen, von der der Autor der Erweiterung angegeben hat, dass sie nicht funktioniert. Ermitteln Sie das verantwortliche Paket.
composer why-not flarum/core 1.8.20Die Ausgabe listet jedes Paket auf, das diese Version blockiert, sowie die von ihm festgelegte Bedingung. Danach haben Sie zwei Möglichkeiten: Warten Sie, bis der Autor eine kompatible Version veröffentlicht, oder entfernen Sie die Erweiterung und verzichten Sie darauf. Das ist der Preis des Composer-Modells. Sie sollten ihn verstehen, bevor Sie 15 Erweiterungen in einem Forum installieren, auf das andere angewiesen sind. Bevorzugen Sie Erweiterungen, die kürzlich eine Version veröffentlicht haben, und halten Sie die Liste kurz genug, um sie lesen zu können.
Diese Befehle halten Sie innerhalb von 1.x. Der Wechsel von 1.8 zu 2.0 ist ein umfangreiches Upgrade mit einer eigenen Anleitung in der Flarum-Dokumentation. Es erfordert PHP 8.3, Änderungen an composer.json, eine driver-Änderung in config.php bei MariaDB-Installationen sowie die Entfernung aller Erweiterungen, für die keine 2.0-Version verfügbar ist.
Was Sie sichern sollten
Sichern Sie die Datenbank und das Projektverzeichnis. Alles andere lässt sich neu erstellen.
mariadb-dump -u flarum -p --single-transaction flarum > flarum-$(date +%F).sql
sudo tar czf flarum-files.tgz -C /srv flarumAuf älteren Systemen heißt mariadb-dump mysqldump; unter Ubuntu 24.04 funktionieren beide Bezeichnungen. Die Datenbank enthält jeden Beitrag, jeden Benutzer und jede Einstellung. Das Projektverzeichnis enthält config.php, composer.json, das die tatsächliche Liste der verwendeten Erweiterungen enthält, und assets/ mit hochgeladenen Avataren und Logos. vendor/ können Sie auslassen, weil composer install es aus composer.lock neu erstellt und storage/ sich selbst regeneriert. Kopieren Sie beide Dateien vom Server weg, denn ein Backup auf dem Rechner, den es schützen soll, ist kein Backup. Für eine Wiederherstellung benötigen Sie eine frische Flarum-Installation derselben Version, composer install, die gespeicherten Dateien an ihrem ursprünglichen Speicherort und die geladene SQL-Datei.
FAQ
Kann Flarum auf einem 1 GB VPS ausgeführt werden?
Ja, für eine kleine Community. Im normalen Betrieb besteht Flarum aus PHP-FPM, das Anfragen verarbeitet, und MariaDB. Mit pm = ondemand existieren die PHP-Worker nur, während jemand Seiten liest. Die höchste Speicherauslastung entsteht bei der Installation selbst: composer create-project löst den gesamten Abhängigkeitsbaum im Arbeitsspeicher auf. Dieser Schritt wird am ehesten vom Out-of-Memory-Killer beendet. Legen Sie vor der Installation eine Swap-Datei an. Alternativ können Sie Composer einmal auf einer größeren Maschine ausführen und den Verzeichnisbaum anschließend kopieren.
Warum liefern Links zu Diskussionen 404, während die Startseite funktioniert?
In Ihrem nginx-Server-Block fehlt include /srv/flarum/.nginx.conf;. Flarum verarbeitet URLs wie /d/1-hello-world innerhalb von PHP. Dieser Pfad ist keine Datei auf dem Datenträger. Ohne die try_files $uri $uri/ /index.php?$query_string-Regel aus dem Snippet sucht nginx nach einem Verzeichnis namens d, schlägt dabei fehl und gibt selbst 404 zurück, ohne PHP aufzurufen. Unter Apache wird dasselbe Routing durch public/.htaccess bereitgestellt. Dieses wird ignoriert, sofern der <Directory>-Block nicht AllowOverride All setzt.
Warum hat mein Forum nach der Aktivierung von HTTPS seine gesamte Formatierung verloren?
Flarum speichert seine Basis-URL in config.php. Dieser Wert wird anhand der Adresse übernommen, die Sie bei der Ausführung des Installationsprogramms verwendet haben. Wenn Sie die Installation über reines HTTP ausgeführt haben, erzeugt Flarum weiterhin http://-URLs für Assets. Der Browser blockiert diese auf einer HTTPS-Seite als Mixed Content. Dadurch wird nur unformatierter Text angezeigt. Ändern Sie den Schlüssel url in /srv/flarum/config.php auf die https://-Adresse. Führen Sie anschließend php flarum cache:clear als Benutzer aus, dem die Dateien gehören.
Warum erhält niemand die Bestätigungs-E-Mail für die Registrierung?
Prüfen Sie zuerst den Mail-Treiber. Der mail-Treiber benötigt eine lokale sendmail-Binärdatei, die auf einem neu eingerichteten Ubuntu-VPS nicht vorhanden ist. Der log-Treiber schreibt nach storage/logs/ und versendet keine Nachrichten. Wechseln Sie zu smtp. Verwenden Sie Port 587 und setzen Sie die Verschlüsselung auf tls, weil die meisten Anbieter ausgehenden Port 25 blockieren. Klicken Sie anschließend auf Send Test Mail. Wenn das Log einen erfolgreichen Versand meldet, die E-Mail aber weiterhin nicht ankommt, liegt das Problem bei der Zustellbarkeit und nicht bei der Konfiguration. Veröffentlichen Sie daher SPF- und DKIM-Einträge für Ihre Versanddomain.
Sollte ich Flarum 1.8 oder 2.0 installieren?
Installieren Sie vorerst 1.8, wenn Ihr Forum von Erweiterungen anderer Anbieter abhängt. Flarum 2.0.0 wurde am 9. Oktober 2026 als stabile Version veröffentlicht. Am 12. Oktober 2026 weist der Upgrade-Leitfaden von Flarum jedoch darauf hin, dass viele Erweiterungen bisher nur Beta-Versionen für 2.0 veröffentlicht haben. Erweiterungen ohne 2.0-Version deklarieren weiterhin eine flarum/core-Anforderung, die bei 1.x endet. Wenn Sie heute 2.0 installieren, lehnt Composer diese Erweiterungen direkt ab. Das ist derselbe Konflikt bei Abhängigkeiten, den composer why-not diagnostizieren soll. Fixieren Sie die Version mit flarum/flarum:^1.8.0. Wechseln Sie über den Upgrade-Leitfaden von Flarum zu 2.0, sobald die von Ihnen benötigten Erweiterungen stabile 2.0-Versionen anbieten. Beachten Sie, dass 1.x inzwischen nur noch Fehlerbehebungen für kritische Fehler und Sicherheitsprobleme erhält. Ein Forum ohne Abhängigkeiten von Erweiterungen anderer Anbieter kann heute mit flarum/flarum:^2.0.0 auf 2.0 gestartet werden.