Проверено: Chrome / Chromium 147.0.7727.101

Зачем это нужно

Modus BI использует headless-Chromium для автоматической генерации отчётов в PDF/PNG/SVG/PPTX (API POST /v1/api/exports, команда automated). Без корректно установленного браузера и заполненного блока browser в modusbi.json экспорт не заработает.

Данная статья отвечает на два вопроса:

1. Как поставить Chrome/Chromium на целевую ОС.
2. Что именно записать в modusbi.json.

Windows 10 / 11

Шаг 1. Установить Google Chrome.

Скачайте инсталлятор с google.com/chrome и запустите ChromeSetup.exe.

Путь по умолчанию: C:\Program Files\Google\Chrome\Application\chrome.exe.

Шаг 2. Проверить установку.

В PowerShell:

& "C:\Program Files\Google\Chrome\Application\chrome.exe" --version
# Ожидаемый вывод: Google Chrome 147.0.7727.101

Шаг 3. Настроить modusbi.json

Путь к файлу конфигурации портала на Windows — обычно C:\Program Files\ModusBI\etc\modusbi.json.

{
  "browser": {
    "exec_path": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
    "disable_gpu": true,
    "no_sandbox": false
  }
}

Шаг 4. Перезапустить сервис портала.

Restart-Service ModusBI

Debian 12 (Bookworm) / Debian 13 (Trixie)

На Debian используем системный пакет chromium — он актуальный и не завязан на snap. На момент публикации в репозиториях доступна версия 147.0.7727.101-1~deb12u1 / -1~deb13u1.

Шаг 1. Установить Chromium.

sudo apt-get update
sudo apt-get install -y chromium

Шаг 2. Проверить установку.

which chromium
# /usr/bin/chromium

chromium --version
# Chromium 147.0.7727.101 built on Debian GNU/Linux 12 (bookworm)

Шаг 3. Настроить modusbi.json

Путь к файлу — обычно /etc/modusbi/modusbi.json.

{
  "browser": {
    "exec_path": "/usr/bin/chromium",
    "disable_gpu": true,
    "no_sandbox": false
  }
}

Шаг 4. Перезапустить сервис портала.

sudo systemctl restart modusbi

Ubuntu 22.04 / Ubuntu 24.04

Шаг 1. Установить Google Chrome.

cd /tmp
wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo apt-get install -y ./google-chrome-stable_current_amd64.deb

Пакет автоматически подтянет все необходимые библиотеки (libnss3, libgtk-3-0, libasound2/libasound2t64 на 24.04 и т.д.).

Шаг 2. Проверить установку.

which google-chrome
# /usr/bin/google-chrome

google-chrome --version
# Google Chrome 147.0.7727.101

/usr/bin/google-chrome — симлинк через /etc/alternatives/google-chrome на /opt/google/chrome/google-chrome. В конфиге портала рекомендуется указывать /usr/bin/google-chrome — он стабилен между обновлениями пакета.

Шаг 3. Настроить modusbi.json

{
  "browser": {
    "exec_path": "/usr/bin/google-chrome",
    "disable_gpu": true,
    "no_sandbox": false
  }
}

Шаг 4. Перезапустить сервис портала.

sudo systemctl restart modusbi

Сводная таблица путей для exec_path

ОС	Способ установки	Значение exec_path
Windows 10 / 11	Google Chrome (инсталлятор)	C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe
Debian 12 / 13	apt install chromium	/usr/bin/chromium
Ubuntu 22.04 / 24.04	Google Chrome .deb	/usr/bin/google-chrome

 

Значение пустой строки ("exec_path": "") включает автопоиск Chrome/Chromium в системе. Работает на всех трёх ОС, но явный путь предпочтительнее — это исключает ситуацию «портал нашёл не тот браузер».

Разбор полей modusbi.json → browser

Поле	Тип	Значение по умолчанию	Когда менять
exec_path	строка	"" (автопоиск)	Практически всегда — задавайте явный путь из таблицы выше.
disable_gpu	bool	true	Оставляйте true на серверах без видеокарты (это большинство сценариев).
no_sandbox	bool	false	Оставляйте false. Менять на true только если портал работает внутри уже изолированного контейнера под non-root пользователем и sandbox мешает старту.

 

Готовые примеры modusbi.json

Windows:

{
  "browser": {
    "exec_path": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
    "disable_gpu": true,
    "no_sandbox": false
  }
}

Debian 12 / 13:

{
  "browser": {
    "exec_path": "/usr/bin/chromium",
    "disable_gpu": true,
    "no_sandbox": false
  }
}

Ubuntu 22.04 / 24.04:

{
  "browser": {
    "exec_path": "/usr/bin/google-chrome",
    "disable_gpu": true,
    "no_sandbox": false
  }
}