Flarum¶

Flarum is the next-generation forum software that makes online discussion fun. It’s simple, fast, and free.

Note

For this guide you should be familiar with the basic concepts of

Prerequisites¶

We’re using PHP in the stable version 7.2:

[isabell@stardust ~]$ uberspace tools version show php
Using 'PHP' version: '7.2'
[isabell@stardust ~]$

You’ll need your MySQL credentials. Get them with my_print_defaults:

[isabell@stardust ~]$ my_print_defaults client
--default-character-set=utf8mb4
--user=isabell
--password=MySuperSecretPassword
[isabell@stardust ~]$

Your website domain needs to be set up:

[isabell@stardust ~]$ uberspace web domain list
isabell.uber.space
[isabell@stardust ~]$

Installation¶

We create the database and install Flarum using composer.

[isabell@stardust ~]$ mysql -e "CREATE DATABASE ${USER}_flarum"
[isabell@stardust ~]$ cd /var/www/virtual/$USER/
[isabell@stardust isabell]$ composer create-project flarum/flarum flarum --stability=beta
[…]
[isabell@stardust isabell]$ rmdir html
[isabell@stardust isabell]$ ln -s flarum html
[isabell@stardust isabell]$

Configuration¶

After the installation you need to open isabell.uber.space/public in your browser to finish your setup.

Fill out your forum title, admin user and edit the following database settings:

MySQL Database: isabell_flarum
MySQL Username: isabell
MySQL Password from your MySQL credentials

Tested with Flarum v0.1.0-beta.11 and Uberspace 7.4

Written by: Thomas Kammerer <https://kammerer.tk/>