Установка Flarum: три способа

Flarum ставится через Composer, из готового архива или в Docker. Разбираем все три варианта и подключаем русский язык.

Редакция IpbordaОбновлено 20 ноября 2026 г.

У 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

Это основной способ: так проще обновляться и ставить расширения.

  1. Подключитесь к серверу по SSH и перейдите в пустой каталог будущего форума.
  2. Выполните:
composer create-project flarum/flarum .
  1. Направьте корень сайта (document root) на папку public внутри этого каталога.
  2. Выдайте веб-серверу права на запись в storage, public/assets и корневой каталог на время установки.
  3. Откройте домен в браузере. Веб-установщик спросит название форума, данные базы и учётную запись администратора.

После установки в корне появится 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-каталога.