Flarum installieren

Allgemein

Beschreibung

Flarum ist ein freies Forensystem, das sich als Foren-Software der nächsten Generation bezeichnet und Online-Diskussionen zu einem Vergnügen machen will. Es wirbt damit, einfach, schnell und frei zu sein.

Flarum läuft mit PHP und MySQL und lässt sich auf Linux betreiben. Die Installation mit Composer stellt für Benutzer von anderen shared Hosting Umgebungen ein Hindernis dar, bei Hostsharing dagegen ist Composer kein Problem und ermöglicht eine sehr einfache Installation.

Flarum ist der kombinierte Nachfolger von esoTalk und FluxBB.

Flarum steht unter der MIT Lizenz.

Seit Mai 2021 gibt es nun die stabile Version 1.0.

Die Entwicklung von Flarum geschieht in der Freizeit der Hauptentwickler, daher scheint es oft, das Projekt tritt auf der Stelle. Dennoch gibt es immer wieder Fortschritte, die man auf https://discuss.flarum.org/t/blog verfolgen kann.

Installation

Design

Diese Installationsanleitung beschreibt, wie Flarum in einer eigens dafür aufgeschalteten Subdomain über SSL betrieben wird. Für andere Konfigurationen, wie z.B. die Installation von Flarum in einer als Unterverzeichnis von ~/doms/domain/subs/ erstellten Subdomain, muß dieses Verfahren leicht angepaßt werden.

Der Vorteil einer Installation in einer aufgeschalteten Subdomain ist, daß die Installation leicht von anderen Domaininhalten, PHP-Konfigurationen, oder sogar von anderen Domain-Administratoren, isoliert werden kann.

Subdomain aufschalten

Im Folgenden werden folgende Domainkonfigurationsdaten als Beispiel verwendet:

Typ	Wert	Beschreibung
Subdomain	discuss.example.org	Die Subdomain, unter der eine Flarum-Instanz laufen soll
Domain-Admin	xyz00-hans	Der User, dem die Subdomain delegiert wurde

PHP 7.4

Flarum läuft gut mit dem bei uns installierten PHP 7.4. Daher sind hier keine Anpassungen notwendig.

Quellen

Die Quellen befinden sich unter:

• https://github.com/flarum/core

Allerdings empfiehlt sich die Installation über Composer.

Installation mit Composer

Es sollte eine neuere Version von Composer (momentan 2.4.2) installiert werden, weil die Default Installation schon sehr alt ist (1.8.4). Siehe auch https://getcomposer.org/download/ für den aktuell gültigen sha hash...

mkdir ~/composer
cd ~/composer
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === '55ce33d7678c5a611085589f1f3ddf8b3c52d662cd01d4ba75c0ee0459970c2200a51f492d557530c71c15d8dba01eae') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"

Nun zur eigentlichen Installation:

cd ~
mkdir flarum
cd flarum
php ~/composer/composer.phar create-project flarum/flarum .
# deutsches Sprachpaket installieren:
php ~/composer/composer.phar require flarum-lang/german
# um Platz zu sparen:
rm -Rf ~/.cache/composer
cd ~/doms/discuss.example.org
rm -Rf htdocs-ssl
ln -s ~/flarum/public htdocs-ssl

MySQL vorbereiten

Flarum benötigt eine MySQL-Datenbank sowie einen Datenbanknutzer.

Die Tabellen werden später vom Installations-Werkzeug von Flarum eigenständig angelegt.

Datenbank und Datenbanknutzer anlegen

In dieser Anleitung werden folgende Namen für die Datenbank und deren Nutzer verwendet. Das Paket-Kürzel xyz00 ist natürlich durch das des betreffenden Pakets zu ersetzen.

Typ	Wert	Beschreibung
DB-Nutzer	xyz00_flarum	Der MySQL-Nutzer, dem die Datenbank gehört und der administrative Tätigkeiten durchführt und dann auch im Betrieb genutzt wird.
Datenbank	xyz00_flarum	Die MySQL-Datenbank, die die Daten von Flarum enthält.

Der Nutzer und die Datenbank können über die Weboberfläche auf https://admin.hostsharing.net oder über die Kommandozeile mit Hsadmin angelegt werden. Siehe dazu die Anleitungen auf der Seite MySQL und Datenbanken. Diese Schritte müssen ggf. vom Paket-Admin vorgenommen werden.

Einrichtung über die Kommandozeile:

Als Besitzer der Flarum-Datenbank xyz00_flarum angeben; als Zeichenkodierung ist das Default UTF-8 richtig.

su xyz00
hsscript -u xyz00 -e "mysqluser.add ({set:{name:'xyz00_flarum',password:'geheim'}})"
hsscript -u xyz00 -e "mysqldb.add ({set:{name:'xyz00_flarum',owner:'xyz00_flarum',encoding:'utf-8'}})"
exit

Installation durchführen

Die URL zur Installation von Flarum lautet schlicht und einfach https://discuss.example.org.

Man gibt bei Forum Title den gewünschten Namen des Forums ein. Er kann auch später in den Einstellungen noch geändert werden, im laufenden Betrieb.

Die Datenbank muss wie folgt konfiguriert werden:

• MySQL Host: localhost
• MySQL Database: xyz00_flarum
• MySQL Username: xyz00_flarum
• MySQL Password: geheim
• Table Prefix: kann leer gelassen werden

Admin Username ist der Benutzername des Benutzers, der Administrationsrechte haben soll. Entsprechend ist Admin Email die E-Mail Adresse dieses Benutzers, und Admin Password sein Passwort, dass in Confirm Password wiederholt werden muss.

Nun klickt man auf den Schalter mit der Aufschrift Install Flarum, und die Instanz wird konfiguriert.

Danach wird man in die Flarum Instanz weitergeleitet, und ist direkt als der erstellte Benutzer angemeldet.

Erste Schritte

Man ändert die Sprache in der Titelleiste von Englisch auf Deutsch.

Man sollte dann in die Einstellungen gehen, die man im Menü oben rechts unter dem Benutzer Avatar findet.

Dort kann man die voreingestellte Sprache für das Forum einstellen, und ob man den Wechsel der Sprache erlaubt.

Außerdem lässt sich unter "E-Mail" ein SMTP Zugang für ein E-Mail Konto einrichten, über welches neue Konten eingerichtet werden können und vergessene Passwörter ersetzt werden können.

Es können auch Kategorien definiert werden, damit lassen sich die Diskussionen besser sortieren.

Man kann auch die Zugriffsrechte konfigurieren. Dafür können verschiedene Gruppen eingerichtet werden.

Im Endeffekt kann man auch über die Zugriffsrechte auch ein geschütztes Forum einrichten, wenn man die Registrierung schließt, und das Lesen von Diskussionen nur Mitgliedern erlaubt. Das einzige Problem ist, dass neue Mitglieder in diesem Fall sich nicht selber registrieren können, und notfalls über eine Erweiterung oder per Hand über die Datenbank angelegt werden müssen.

Aktualisierung einer bestehenden Installation

Neue Versionen von Flarum werden auf dem Blog angekündigt: https://discuss.flarum.org/t/blog?sort=newest

In den Versionsankündigungen ist auch immer ein Abschnitt enthalten, der auf Besonderheiten beim Update hinweist. Diese Hinweise sollten befolgt werden!

Siehe auch https://docs.flarum.org/update/

Es sollte immer ein aktuelles Backup angefertigt werden.

Meistens sind diese Anweisungen ausreichend:

cd ~/flarum
php flarum info
php ~/composer/composer.phar update --prefer-dist --no-dev -a --with-all-dependencies
php flarum migrate
php flarum cache:clear
php flarum info
rm -Rf ~/.cache/composer

---