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