Установка Flarum: три способа
Flarum ставится через Composer, из готового архива или в Docker. Разбираем все три варианта и подключаем русский язык.
У Flarum три рабочих способа установки: через Composer (рекомендуемый), из готового архива (если нет SSH) и в Docker (если вы держите сервисы в контейнерах). Ниже — каждый вариант по шагам и подключение русского языка.
Что это за движок и кому он подходит — в обзоре Flarum. Инструкция рассчитана на актуальную ветку Flarum 2.x.
Требования
- PHP 8.3+ с расширениями curl, dom, fileinfo, gd, json, mbstring, openssl, tokenizer, zip, session;
- база данных: MySQL 5.7+ / 8.0.30+, MariaDB 10.3+, PostgreSQL 10+ или SQLite 3.35+ (с соответствующим PDO-расширением PHP);
- Apache с mod_rewrite или Nginx;
- Composer и SSH-доступ — для первого способа и для удобной работы с расширениями.
Для новых установок берите современные версии баз: MySQL 8.4, MariaDB 11.8 или PostgreSQL 15–17. Заранее создайте пустую базу и пользователя с полными правами на неё.
Способ 1. Установка через Composer
Это основной способ: так проще обновляться и ставить расширения.
- Подключитесь к серверу по SSH и перейдите в пустой каталог будущего форума.
- Выполните:
composer create-project flarum/flarum .
- Направьте корень сайта (document root) на папку
publicвнутри этого каталога. - Выдайте веб-серверу права на запись в
storage,public/assetsи корневой каталог на время установки. - Откройте домен в браузере. Веб-установщик спросит название форума, данные базы и учётную запись администратора.
После установки в корне появится config.php с настройками подключения.
Способ 2. Установка из архива
Если SSH нет, используйте готовые архивы из официальной документации Flarum. Они собраны под конкретные версии PHP и бывают двух видов:
- с папкой public — если вы можете направить домен на подкаталог;
- без папки public — если корень сайта менять нельзя (типично для простых хостингов).
Скачайте архив под свою версию PHP, распакуйте его в корень сайта через файловый менеджер и откройте домен в браузере. Дальше — тот же веб-установщик.
Минус способа: ставить и обновлять расширения без консоли сложнее. Во Flarum 2 для этого есть официальный менеджер расширений в админке, но ему тоже нужны права на запись и достаточно памяти PHP.
Настройка веб-сервера
Apache. В дистрибутиве уже есть .htaccess. Убедитесь, что включены mod_rewrite и AllowOverride All для каталога сайта.
Nginx. В корне Flarum лежит файл .nginx.conf с готовыми правилами. Подключите его в конфигурацию сайта:
server {
listen 80;
server_name forum.example.ru;
root /var/www/flarum/public;
index index.php;
include /var/www/flarum/.nginx.conf;
location ~ \.php$ {
fastcgi_pass unix:/run/php/php8.3-fpm.sock;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
}
}
Путь к сокету PHP-FPM поменяйте под свою систему. После проверки выпустите SSL-сертификат, например через certbot.
Способ 3. Flarum в docker compose
Официального Docker-образа у Flarum нет, поэтому есть два пути: взять образ сообщества или собрать свой на базе официального образа PHP. Общая схема docker-compose.yml с образом сообщества выглядит так:
services:
flarum:
image: mondedie/flarum:stable
restart: unless-stopped
env_file: ./flarum.env
volumes:
- ./assets:/flarum/app/public/assets
- ./extensions:/flarum/app/extensions
- ./logs:/flarum/app/storage/logs
ports:
- "8888:8888"
depends_on:
- mariadb
mariadb:
image: mariadb:11
restart: unless-stopped
environment:
MARIADB_ROOT_PASSWORD: change-me-root
MARIADB_DATABASE: flarum
MARIADB_USER: flarum
MARIADB_PASSWORD: change-me
volumes:
- ./db:/var/lib/mysql
В файле flarum.env задаются адрес форума (FORUM_URL), параметры базы (DB_HOST=mariadb, DB_NAME, DB_USER, DB_PASS) и данные первого администратора. Точный список переменных смотрите в описании выбранного образа.
На что обратить внимание:
- Версия внутри образа. Образы сообщества обновляются с задержкой, и тег
stableможет содержать прошлую ветку Flarum. Проверьте версию перед запуском. - Обратный прокси. Контейнер слушает порт 8888; наружу его выставляют через Nginx, Traefik или Caddy с SSL.
- Тома. Данные базы и загрузки храните в томах и включите их в резервное копирование.
Если нужен полный контроль над версией, соберите свой образ: официальный php:8.3-fpm или php:8.3-apache, нужные расширения PHP, Composer и composer create-project flarum/flarum на этапе сборки.
Русский язык
В корне форума выполните:
composer require "flarum-lang/russian:*"
php flarum cache:clear
Затем в админке включите расширение «Russian» и в основных настройках выберите русский языком по умолчанию. В Docker команды выполняются внутри контейнера через docker compose exec. Обновить перевод можно командой composer update flarum-lang/russian.
Обновление Flarum
Обновления внутри ветки 2.x ставятся через Composer: сделайте резервную копию базы и каталога, выполните composer update --prefer-dist --no-dev -a --with-all-dependencies, затем php flarum migrate и php flarum cache:clear. Перед переходом между мажорными версиями проверьте, что все расширения уже совместимы с новой веткой, — иначе Composer откажется обновляться.
Первые шаги после установки
- Настройте почту (SMTP) в админке и отправьте тестовое письмо.
- Создайте теги — основную навигацию форума — и права для групп.
- Поставьте расширения для SEO, антиспама и, при необходимости, загрузки файлов.
- Настройте cron для планировщика задач:
php flarum schedule:runкаждую минуту. - Включите резервное копирование базы и папки
public/assets.
О наполнении нового форума — в статье как раскрутить форум. А если не хочется собирать сервер и разбираться с Composer, закажите форум под ключ — поставим Flarum с русским языком и нужными расширениями.
Частые вопросы
Как установить Flarum без SSH?
Скачайте с официальной документации готовый архив под вашу версию PHP, распакуйте его на хостинге, направьте домен на нужную папку и откройте сайт в браузере — запустится веб-установщик.
Есть ли официальный docker compose для Flarum?
Официального образа у команды Flarum нет. Используют образы сообщества или собственный образ на основе PHP. Важно, чтобы образ содержал нужную вам ветку Flarum и регулярно обновлялся.
Как поставить русский язык во Flarum?
В корне форума выполните composer require с пакетом flarum-lang/russian, затем включите расширение в админке и выберите русский языком по умолчанию.
Какая версия PHP нужна для Flarum 2?
PHP 8.3 или новее с расширениями curl, dom, fileinfo, gd, json, mbstring, openssl, tokenizer, zip и session.
Куда направлять домен при установке Flarum?
В папку public внутри каталога Flarum. Если хостинг не позволяет сменить корень сайта, используйте архив без public-каталога.