mirror of https://github.com/YunoHost-Apps/flarum_ynh.git synced 2024-09-03 18:36:24 +02:00

Flarum, an open-source forum software, packaged for YunoHost

closember flarum forum yunohost yunohost-apps

Find a file

Alexandre Aubin c17edbd66b Bump yunohost requirement due to previous commit		2021-11-08 14:31:27 +01:00
.github	[autopatch] Update issue and PR templates	2021-05-13 21:04:28 +02:00
conf	Do not hide standard login method by default	2021-06-06 11:14:18 +02:00
doc	Add descriptions	2021-09-22 08:14:31 +02:00
scripts	Fix ynh_composer_exec syntax	2021-11-08 14:14:04 +01:00
.gitattributes	👾 Added .gitattributes	2016-10-05 19:43:44 +02:00
.gitignore	Initial commit	2016-10-05 19:44:08 +02:00
check_process	Disable upgrade from older commit	2021-05-16 10:32:55 +02:00
LICENSE	Initial commit	2016-10-05 19:44:08 +02:00
manifest.json	Bump yunohost requirement due to previous commit	2021-11-08 14:31:27 +01:00
README.md	Auto-update README	2021-10-04 22:12:38 +00:00
README_fr.md	Auto-update README	2021-10-04 22:12:38 +00:00

README.md

Flarum for YunoHost

Lire ce readme en français.

This package allows you to install Flarum quickly and simply on a YunoHost server. If you don't have YunoHost, please consult the guide to learn how to install it.

Overview

Flarum is a simple discussion platform for your website. It's fast and easy to use, with all the features you need to run a successful community.

Shipped version: 1.0.0~ynh6

Demo: https://discuss.flarum.org/d/21101-demos-come-to-flarum

Screenshots

Disclaimers / important information

Installing

The installation requires at least 1GB of free memory. A swap file of this size will be created if needed.
You can select the default language (among English en by default, French fr, and German de). Other languages can be added after installation like any other extension.

Using

After installation, simply open your browser to Flarum's page. First loading may be a bit longer as assets are generated.

This app allows your YunoHost users to log in with a dedicated LDAP extension. By default, the standard logging method is hidden. To allow non-YunoHost users to log in, the LDAP extension setting is in the admin panel.

Upgrading

Note that, for the moment, all third-party extensions are removed upon upgrading.

Adding extensions

Flarum does not offer to install extensions from its admin panel yet, so you need to use the command line.

Replace flarum with your app ID in case of multiple installations. Replace vendor/extension with the appropriate names. Read the extension documentation if it requires additional steps.

sudo su
app=flarum
cd /var/www/$app
sudo -u $app php7.3 composer.phar require vendor/extension

Troubleshooting

`Timeout` errors

Some users have reported a successful installation, but get a blank page due to a timeout on a PHP script that prepares the forum assests (Minify.php, notably).

In /etc/php/*php_version*/fpm/pool.d/*app_id*.conf, you can increase the max_execution_time and max_input_time limits (both values are in seconds if nothing is specified).

Reload PHP-FPM with sudo service php*php_version*-fpm reload.

Upload limit

If you are facing an error while uploading large files into the forum, PHP may be limiting file upload.

In /etc/php/*php_version*/fpm/pool.d/*app_id*.conf, you can uncomment (remove ; at the beginning of the line) and increase the values of upload_max_filesize and post_max_size (both values are in bytes).