Установка Dolibarr на Debian 11

О чём эта инструкция

Dolibarr — это бесплатная open‑source ERP/CRM-система для управления клиентами, счетами, заказами, товарами, складом и календарём. Инструкция рассчитана на системных администраторов и инженеров, которые готовы работать в командной строке сервера Debian 11. В тексте сохранены все команды и шаги, показанные в исходном руководстве.

Important: перед началом убедитесь, что у вас есть доступ к серверу с Debian 11, установлен пароль root и доменное имя указывает на ваш сервер.

Что вам потребуется

Сервер с Debian 11
Установлен пароль root или пользователь с sudo
Зарегистрированное доменное имя, направленное на сервер
Базовые навыки работы в консоли Linux

Основные шаги (кратко)

Установить Apache, MariaDB, PHP и модули PHP.
Настроить php.ini для веб‑сервера.
Защитить и создать базу данных MariaDB для Dolibarr.
Скачать и разместить файлы Dolibarr в /var/www/html/dolibarr.
Настроить виртуальный хост Apache и включить модуль rewrite.
Перейти в веб‑интерфейс для завершения установки.
Включить HTTPS с помощью Certbot (Let’s Encrypt).

Установка Apache, MariaDB и PHP

Dolibarr написан на PHP и использует MariaDB как базу данных. На сервере необходимо установить Apache, MariaDB, PHP и набор модулей PHP, которые часто требуются для корректной работы ERP/CRM.

Выполните эту команду:

apt-get install apache2 mariadb-server php libapache2-mod-php php-common php-curl php-intl php-mbstring php-json php-xmlrpc php-soap php-mysql php-gd php-xml php-cli php-zip wget unzip git curl -y

Примечание: в исходной инструкции использован PHP 7.4. Проверьте установленную версию PHP командой php -v и при необходимости адаптируйте путь к php.ini.

Далее отредактируйте php.ini для Apache:

nano /etc/php/7.4/apache2/php.ini

Измените эти параметры (или сопоставимые для вашей версии PHP):

memory_limit = 256M
upload_max_filesize = 64M
max_execution_time = 300
date.timezone = UTC

Сохраните файл и перезапустите сервисы, а также включите автозапуск:

systemctl start apache2
systemctl enable apache2
systemctl start mariadb
systemctl enable mariadb

Создание базы данных для Dolibarr

Перед созданием базы данных стоит запустить встроенный скрипт для базовой защиты MariaDB:

mysql_secure_installation

Ответьте на вопросы, предложенные скриптом (в исходном примере некоторые ответы — Y/N). После этого войдите в консоль MariaDB:

mysql -u root -p

Выполните команды для создания базы данных и пользователя Dolibarr (в примере используется пароль ‘password’ — обязательно замените его на сложный пароль):

MariaDB [(none)]> CREATE DATABASE dolibarr;
MariaDB [(none)]> CREATE USER dolibarr;
MariaDB [(none)]> GRANT ALL PRIVILEGES ON dolibarr.* TO 'dolibarr'@'localhost' IDENTIFIED BY 'password';
MariaDB [(none)]> FLUSH PRIVILEGES;
MariaDB [(none)]> EXIT

Совет: используйте безопасный пароль и по возможности ограничьте доступ пользователя по привилегиям и хостам.

Скачивание и размещение Dolibarr

Скачайте последнюю версию Dolibarr из репозитория GitHub и распакуйте её. В исходном примере команды выглядят так:

release_tag=$(curl -s https://api.github.com/repos/Dolibarr/dolibarr/releases/latest | grep tag_name | cut -d '"' -f 4) wget https://github.com/Dolibarr/dolibarr/archive/${release_tag}.tar.gz

После загрузки распакуйте архив (в примере распаковка конкретной версии):

tar -xvzf 16.0.3.tar.gz

Копируйте директорию в корень веб‑сервера и настройте права:

cp -r dolibarr-16.0.3 /var/www/html/dolibarr
chown -R www-data:www-data /var/www/html/dolibarr/
chmod -R 775 /var/www/html/dolibarr/

Важно: проверяйте имена папок и версии — в примере указана dolibarr-16.0.3.

Настройка Apache для Dolibarr

Создайте виртуальный хост Apache:

nano /etc/apache2/sites-available/dolibarr.conf

Добавьте конфигурацию (замените ServerAdmin и ServerName на ваши значения):


     ServerAdmin [email protected]
     DocumentRoot /var/www/html/dolibarr/htdocs
     ServerName dolibarr.example.com

     
          Options +FollowSymlinks
          AllowOverride All
          Require all granted
     

     ErrorLog ${APACHE_LOG_DIR}/dolibarr_error.log
     CustomLog ${APACHE_LOG_DIR}/dolibarr_access.log combined

Включите сайт и модуль rewrite, затем перезапустите Apache:

a2ensite dolibarr
a2enmod rewrite
systemctl restart apache2

Проверьте статус Apache:

systemctl status apache2

Вы увидите информацию о запущенном сервисе, похожую на вывод в исходной инструкции.

Доступ к веб‑интерфейсу установки

Откройте в браузере http://dolibarr.example.com (замените на ваш домен). В графическом установщике выберите язык, подтвердите PHP‑проверки и укажите настройки базы данных (имя БД, пользователь, пароль). Далее создайте администратора — это последний шаг веб‑установки.

Экран выбора языка в установщике Dolibarr

Проверки PHP перед установкой Dolibarr

Начало установки Dolibarr — стартовая страница

Выбор настроек базы данных в веб‑установщике Dolibarr

Создание администратора Dolibarr

Страница входа в Dolibarr после установки

Дашборд Dolibarr после первого входа

Защита и HTTPS с помощью Let’s Encrypt

Для HTTPS используйте Certbot. В примере используется snap‑пакетный менеджер:

apt install snapd
snap install core
snap refresh core
snap install --classic certbot
ln -s /snap/bin/certbot /usr/bin/certbot

Затем получите сертификат для вашего домена:

certbot --apache -d dolibarr.example.com

Следуйте подсказкам (введите email и согласитесь с условиями). По завершении Certbot автоматически обновит конфигурацию Apache и настроит автоматическое обновление сертификата.

Важно: проверьте, что DNS‑запись A/AAAA указывает на сервер и что порт 80 открыт, иначе валидация не пройдёт.

Критерии приёмки

Веб‑страница https://ваш‑домен открывается и отображает страницу входа Dolibarr.
При входе под созданным администратором виден дашборд.
Права файлов в /var/www/html/dolibarr корректны (www‑data владелец, доступ 775 для директорий).
Сертификат HTTPS действителен и настроен автоматический renewal (letsencrypt).
Бекапы базы данных и файловной структуры настроены (проверка бекапа).

Роли и чек‑листы

Системный администратор:
- Проверить DNS A/AAAA запись.
- Установить и обновить пакеты (apt update && apt upgrade).
- Настроить брандмауэр (например, открыть 80/443).
- Настроить резервное копирование MariaDB и файлов.
Администратор Dolibarr (бизнес‑админ):
- Создать пользователей и профили доступа.
- Импортировать каталоги товаров/клиентов.
- Настроить шаблоны счетов и валидировать бизнес‑процессы.
Разработчик/интегратор:
- Проверить API/модули, интеграции с платёжными шлюзами.
- Тестировать обновления на стенде перед продом.

Мини‑методология внедрения

Развернуть тестовую инстанцию и пройти полный сценарий установки.
Подготовить чек‑лист миграции данных (CSV/SQL) и протестировать импорт.
Настроить права и роли, провести тренинг для пользователей.
Перенести настройки на прод и сделать финальный тест.
Ввести процессы резервного копирования и мониторинга.

Безопасность и рекомендации

Используйте сложные пароли для БД и админа.
Отключите доступ к MariaDB по сети, если он не нужен: слушать только localhost.
Настройте брандмауэр (ufw/iptables) и разрешите только нужные порты.
Настройте автоматическое обновление безопасности для сервера.
Регулярно выполняйте бекапы и проверяйте их восстановление.

Советы по отладки (частые ошибки)

Проблема: «Белая страница» или ошибки PHP — проверьте логи Apache (/var/log/apache2/) и PHP‑ошибки.
Проблема: не удаётся пройти проверку PHP в установщике — убедитесь, что установлены все перечисленные модули php‑mbstring, php‑xml, php‑mysql и т. п.
Проблема: Certbot не может верифицировать домен — проверьте DNS и доступность порта 80.

Когда Dolibarr может не подойти

Если вам нужен сложный, высокоспециализированный ERP с глубокой кастомизацией модулей (требуется оценка возможностей и доработок).
Если инфраструктура предполагает многокластерную БД с масштабированием вне шаблона LAMP — потребуется архитектурная адаптация.

Таблица совместимости (ключевые компоненты)

Операционная система: Debian 11 (в инструкции)
Веб‑сервер: Apache (рекомендован)
База данных: MariaDB
Язык: PHP (пример на PHP 7.4) — проверить требования текущей версии Dolibarr

Шаблоны команд и чек‑лист быстрого запуска

Установка пакетов:

apt-get install apache2 mariadb-server php libapache2-mod-php php-common php-curl php-intl php-mbstring php-json php-xmlrpc php-soap php-mysql php-gd php-xml php-cli php-zip wget unzip git curl -y

Настройка прав для web:

chown -R www-data:www-data /var/www/html/dolibarr/
chmod -R 775 /var/www/html/dolibarr/

Включение сайта и перезапуск Apache:

a2ensite dolibarr
a2enmod rewrite
systemctl restart apache2

Получение сертификата:

certbot --apache -d dolibarr.example.com

Резюме

Dolibarr — хороший выбор как open‑source ERP/CRM для малого и среднего бизнеса. На Debian 11 установка выполняется по стандартной схеме LAMP: Apache + PHP + MariaDB. После размещения файлов и настройки виртуального хоста веб‑установщик доведёт процесс до конца. Для защиты рекомендуем включить HTTPS через Let’s Encrypt и настроить бекапы.

Notes: проверяйте требования к версии PHP для конкретного релиза Dolibarr и тестируйте обновления на отдельной среде перед продакшеном.

Если нужно, могу подготовить:

готовый systemd‑юнит для резервного копирования,
пример правила UFW для продового сервера,
или пошаговый playbook для Ansible, который автоматизирует весь процесс.