Установка Dolibarr через apt (пакет .deb)

В этом руководстве описано, как установить Dolibarr ERP/CRM на сервер Ubuntu или Debian с помощью apt и официального пакета .deb (DoliDeb). Этот метод позволяет apt автоматически разрешить зависимости (Apache, MySQL/MariaDB, PHP) и предоставляет мастер настройки во время установки.

Dolibarr больше нет в стандартных репозиториях

Начиная с Ubuntu 18.04, пакет dolibarr больше не входит в официальные репозитории Ubuntu/Debian. Команда apt install dolibarr вернёт ошибку «пакет не найден» на новых версиях. Рекомендуемый сегодня способ — загрузить официальный пакет .deb, публикуемый проектом Dolibarr, и установить его с помощью apt, который обрабатывает зависимости.

Заказать сервер

Для размещения вашего экземпляра Dolibarr HostMyServers предлагает несколько подходящих вариантов:

VPS Performance - Идеально для малого бизнеса
VPS NVMe - Отличное соотношение цены и качества
Выделенные серверы Eco - Для развёртываний с высокой нагрузкой
Выделенные серверы Performance - Максимальная производительность

Требования

Доступ по SSH как root или пользователь с sudo
Система Ubuntu 24.04 LTS или Debian 12 64-бит
Процессор x64
Минимум 1 ГБ ОЗУ (2 ГБ рекомендуется для Dolibarr + база данных)
Около 5 ГБ свободного места на диске (рекомендуется SSD)
Доступный порт 80 (и 443 для HTTPS)

Необходимая конфигурация

Компонент	Минимум	Рекомендуется
ОЗУ	1 ГБ	2-4 ГБ
ЦП	1 ядро	2 ядра
Хранилище	5 ГБ SSD	20 ГБ SSD
Сеть	100 Мбит/с	1 Гбит/с

Программный стек

Dolibarr работает на стеке LAMP: веб-сервер (Apache рекомендуется), база данных (MySQL / MariaDB) и PHP. Пакет .deb устанавливает и настраивает эти компоненты за вас через apt.

Подключение к серверу

Убедитесь, что вы подключены к серверу перед началом. В зависимости от вашего окружения:

Подключение с именем пользователя и IP (порт по умолчанию)

Если сервер использует стандартный порт SSH (22):

ssh пользователь@ip_адрес_сервера

пользователь: имя для входа на сервер
ip_адрес_сервера: IP-адрес, назначенный вашему серверу

Подключение с нестандартным портом

Если сервер использует порт SSH, отличный от 22:

ssh -p номер_порта пользователь@ip_адрес_сервера

Подключение с ключом PEM

Если требуется аутентификация по ключу PEM:

ssh -i /путь/к/вашему/ключу.pem пользователь@ip_адрес_сервера

Выберите метод, соответствующий вашей конфигурации. После подключения можно продолжить установку.

Обновление системы

Обновите сервер перед установкой Dolibarr:

sudo apt-get update
sudo apt-get upgrade -y

Загрузка официального пакета .deb

Загрузите пакет Debian/Ubuntu из официального репозитория Dolibarr. На момент написания последняя стабильная версия — Dolibarr 23.0.3.

cd /tmp
wget https://www.dolibarr.org/files/stable/package_debian-ubuntu/dolibarr_23.0.3-4_all.deb

Проверьте последнюю версию

Просмотрите индекс стабильных пакетов, чтобы найти самую свежую версию, и скорректируйте имя файла в командах.

Установка через apt

Установите пакет с помощью apt install, добавив к пути префикс ./. В отличие от dpkg -i, apt автоматически разрешает и устанавливает зависимости (Apache, MariaDB/MySQL, PHP и расширения):

sudo apt install ./dolibarr_23.0.3-4_all.deb

Путь обязателен

Префикс ./ (или абсолютный путь, например /tmp/dolibarr_23.0.3-4_all.deb) обязателен: без него apt ищет пакет с именем «dolibarr» в репозиториях и завершается ошибкой.

Мастер настройки

Во время установки появляется мастер debconf, который задаёт несколько вопросов. Используйте стрелки, пробел для выбора и Tab/Enter для подтверждения.

Вопрос	Рекомендуемый ответ
Веб-сервер для автоматической перенастройки	Отметьте apache2
Настроить базу данных с dbconfig-common?	Да
Пароль административного пользователя БД (root MySQL/MariaDB)	Введите / подтвердите надёжный пароль
Пароль приложения для базы данных `dolibarr`	Введите отдельный пароль для Dolibarr

Запишите ваши пароли

Сохраните пароль root базы данных и пароль приложения базы dolibarr: они понадобятся для обслуживания или устранения неполадок.

Если установка останавливается из-за отсутствующей зависимости, исправьте её и перезапустите настройку:

sudo apt-get install -f -y
sudo dpkg-reconfigure dolibarr

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

После завершения установки откройте браузер и перейдите по адресу:

http://ip_или_домен_сервера/dolibarr/

При первом обращении Dolibarr запускает мастер установки в браузере:

Проверка окружения (PHP, расширения, права на запись)
Параметры подключения к базе данных (заранее заполнены dbconfig-common)
Создание учётной записи администратора Dolibarr (логин и пароль)
Завершение установки и доступ к панели управления

Заблокируйте установку

По окончании мастера Dolibarr создаёт файл блокировки install.lock, чтобы предотвратить повторный запуск. Проверьте его наличие для защиты доступа:

ls -l /var/lib/dolibarr/documents/install.lock

Настройка брандмауэра

Если UFW активен, откройте веб-порты:

sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw reload

Защита доступа с помощью HTTPS

В продакшене защитите доступ к Dolibarr SSL-сертификатом. Самый простой способ под Apache — Certbot / Let's Encrypt:

sudo apt-get install -y certbot python3-certbot-apache
sudo certbot --apache -d ваш-домен.ru

Certbot автоматически настраивает виртуальный хост Apache и перенаправление HTTP → HTTPS.

Доменное имя

Сертификат Let's Encrypt требует доменного имени, указывающего на IP вашего сервера. См. наше руководство по созданию записи A, указывающей на IP вашего сервера.

Полезные команды

Команда	Описание
`sudo systemctl restart apache2`	Перезапустить веб-сервер
`sudo systemctl status apache2`	Статус Apache
`sudo systemctl status mariadb`	Статус базы данных
`sudo dpkg-reconfigure dolibarr`	Перезапустить мастер настройки
`sudo tail -f /var/log/apache2/error.log`	Следить за ошибками Apache/PHP

Структура файлов

Путь	Описание
`/usr/share/dolibarr/htdocs/`	Исходный код приложения
`/etc/dolibarr/conf.php`	Основной файл конфигурации
`/etc/dolibarr/install.forced.php`	Параметры, заданные при установке
`/var/lib/dolibarr/documents/`	Документы, сгенерированные PDF, резервные копии и файл `install.lock`
`/var/log/apache2/error.log`	Журнал ошибок веб-сервера

Обновление Dolibarr

Чтобы перейти на более новую версию, загрузите новый пакет .deb и установите его поверх существующего — apt выполнит миграцию:

cd /tmp
wget https://www.dolibarr.org/files/stable/package_debian-ubuntu/dolibarr_НОВАЯ_ВЕРСИЯ_all.deb
sudo apt install ./dolibarr_НОВАЯ_ВЕРСИЯ_all.deb

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

Резервная копия перед обновлением

Создайте резервную копию базы данных и папки /var/lib/dolibarr/documents/ перед любым обновлением:

sudo mysqldump -u root -p dolibarr > /root/dolibarr_backup.sql
sudo tar czf /root/dolibarr_documents.tar.gz /var/lib/dolibarr/documents

Устранение неполадок

«Package not found» при выполнении `apt install dolibarr`

Пакета больше нет в репозиториях: используйте официальный файл .deb, как описано выше.
Убедитесь, что вы добавили к имени префикс ./ или абсолютный путь.

Ошибки зависимостей при установке

Исправьте зависимости: sudo apt-get install -f -y
Затем перезапустите настройку: sudo dpkg-reconfigure dolibarr

Не удаётся получить доступ к `/dolibarr/`

Проверьте, что Apache запущен: sudo systemctl status apache2
Проверьте, что модуль PHP активен: sudo apachectl -M | grep php
Просмотрите журнал: sudo tail -f /var/log/apache2/error.log

Ошибка подключения к базе данных

Проверьте, что MariaDB/MySQL запущен: sudo systemctl status mariadb
Проверьте учётные данные в /etc/dolibarr/conf.php
Проверьте подключение: mysql -u root -p -e "SHOW DATABASES;"

Мастер установки больше не появляется

Если файл install.lock существует, мастер заблокирован (нормальное поведение). Чтобы намеренно запустить его снова: sudo rm /var/lib/dolibarr/documents/install.lock (удаляйте только осознанно).

Заказать сервер​

Требования​

Необходимая конфигурация​

Подключение к серверу​

Подключение с именем пользователя и IP (порт по умолчанию)​

Подключение с нестандартным портом​

Подключение с ключом PEM​

Обновление системы​

Загрузка официального пакета .deb​

Установка через apt​

Мастер настройки​

Доступ к веб-интерфейсу​

Настройка брандмауэра​

Защита доступа с помощью HTTPS​

Полезные команды​

Структура файлов​

Обновление Dolibarr​

Устранение неполадок​

«Package not found» при выполнении apt install dolibarr​

Ошибки зависимостей при установке​

Не удаётся получить доступ к /dolibarr/​

Ошибка подключения к базе данных​

Мастер установки больше не появляется​

Ссылки​