Installer Dolibarr via apt (paquet .deb)
Ce guide vous explique comment installer Dolibarr ERP/CRM sur un serveur Ubuntu ou Debian en utilisant apt et le paquet .deb officiel (DoliDeb). Cette méthode laisse apt résoudre automatiquement les dépendances (Apache, MySQL/MariaDB, PHP) et propose un assistant de configuration à l'installation.
Depuis Ubuntu 18.04, le paquet dolibarr n'est plus fourni dans les dépôts officiels Ubuntu/Debian. La commande apt install dolibarr renverra donc une erreur « paquet introuvable » sur les versions récentes. La méthode recommandée aujourd'hui consiste à récupérer le paquet .deb officiel publié par le projet Dolibarr puis à l'installer avec apt, qui se charge des dépendances.
Commander un serveur
Pour héberger votre instance Dolibarr, HostMyServers propose plusieurs offres adaptées :
- VPS Performance - Idéal pour les petites structures
- VPS NVMe - Excellent rapport qualité/prix
- Serveurs dédiés Eco - Pour les déploiements avec charge importante
- Serveurs dédiés Performance - Performance maximale
Prérequis
- Accès SSH root ou utilisateur avec sudo
- Système Ubuntu 24.04 LTS ou Debian 12 64 bits
- Processeur x64
- Minimum 1 Go de RAM (2 Go recommandés pour Dolibarr + base de données)
- Environ 5 Go d'espace disque libre (SSD recommandé)
- Port 80 (et 443 pour HTTPS) accessible
Configuration requise
| Composant | Minimum | Recommandé |
|---|---|---|
| RAM | 1 Go | 2-4 Go |
| CPU | 1 cœur | 2 cœurs |
| Stockage | 5 Go SSD | 20 Go SSD |
| Réseau | 100 Mbps | 1 Gbps |
Dolibarr repose sur une pile LAMP : un serveur web (Apache conseillé), une base de données (MySQL / MariaDB) et PHP. Le paquet .deb installe et configure ces composants pour vous via apt.
Connexion au serveur
Assurez-vous d'être connecté à votre serveur avant de commencer. Selon votre environnement :
Connexion avec utilisateur et adresse IP (port par défaut)
Si le serveur utilise le port SSH standard (22) :
ssh utilisateur@adresse_ip_serveur
- utilisateur : nom de connexion du serveur
- adresse_ip_serveur : adresse IP attribuée à votre serveur
Connexion avec un port personnalisé
Si le serveur utilise un port SSH différent de 22 :
ssh -p numero_port utilisateur@adresse_ip_serveur
Connexion avec une clé PEM
Si l'authentification par clé PEM est requise :
ssh -i /chemin/vers/votre/cle.pem utilisateur@adresse_ip_serveur
Choisissez la méthode adaptée à votre configuration. Une fois connecté, vous pouvez poursuivre l'installation.
Mise à jour du système
Mettez à jour votre serveur avant d'installer Dolibarr :
sudo apt-get update
sudo apt-get upgrade -y
Téléchargement du paquet .deb officiel
Récupérez le paquet Debian/Ubuntu depuis le dépôt officiel Dolibarr. Au moment de la rédaction, la dernière version stable est Dolibarr 23.0.3.
cd /tmp
wget https://www.dolibarr.org/files/stable/package_debian-ubuntu/dolibarr_23.0.3-4_all.deb
Consultez l'index des paquets stables pour trouver la version la plus récente et adaptez le nom du fichier dans les commandes.
Installation via apt
Installez le paquet avec apt install en préfixant le chemin par ./. Contrairement à dpkg -i, apt résout et installe automatiquement les dépendances (Apache, MariaDB/MySQL, PHP et extensions) :
sudo apt install ./dolibarr_23.0.3-4_all.deb
Le préfixe ./ (ou un chemin absolu comme /tmp/dolibarr_23.0.3-4_all.deb) est indispensable : sans lui, apt cherche un paquet nommé « dolibarr » dans les dépôts et échoue.
Assistant de configuration
Pendant l'installation, un assistant debconf s'affiche et vous pose plusieurs questions. Utilisez les flèches, la barre d'espace pour cocher et Tab/Entrée pour valider.
| Question | Réponse conseillée |
|---|---|
| Serveur web à reconfigurer automatiquement | Cochez apache2 |
| Configurer la base de données avec dbconfig-common ? | Oui |
| Mot de passe administrateur de la base (root MySQL/MariaDB) | Saisissez / confirmez un mot de passe fort |
Mot de passe applicatif de la base dolibarr | Saisissez un mot de passe dédié à Dolibarr |
Conservez précieusement le mot de passe root de la base et le mot de passe applicatif de la base dolibarr : ils seront nécessaires en cas de maintenance ou de dépannage.
Si l'installation s'interrompt sur une dépendance manquante, réparez-la puis relancez la configuration :
sudo apt-get install -f -y
sudo dpkg-reconfigure dolibarr
Accès à l'interface web
Une fois l'installation terminée, ouvrez un navigateur et accédez à :
http://adresse_ip_ou_domaine/dolibarr/
Au premier accès, Dolibarr lance un assistant d'installation dans le navigateur :
- Vérification de l'environnement (PHP, extensions, droits d'écriture)
- Paramètres de connexion à la base de données (préremplis par dbconfig-common)
- Création du compte administrateur Dolibarr (identifiant et mot de passe)
- Fin de l'installation et accès au tableau de bord
À la fin de l'assistant, Dolibarr crée un fichier de verrou install.lock pour empêcher toute réexécution. Vérifiez sa présence pour sécuriser l'accès :
ls -l /var/lib/dolibarr/documents/install.lock
Configuration du pare-feu
Si UFW est actif, ouvrez les ports web :
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw reload
Sécuriser l'accès en HTTPS
En production, protégez l'accès à Dolibarr avec un certificat SSL. La méthode la plus simple sous Apache est Certbot / Let's Encrypt :
sudo apt-get install -y certbot python3-certbot-apache
sudo certbot --apache -d votre-domaine.fr
Certbot configure automatiquement le virtualhost Apache et la redirection HTTP → HTTPS.
Un certificat Let's Encrypt nécessite un nom de domaine pointant vers l'IP de votre serveur. Consultez notre guide pour créer un enregistrement A vers l'IP de votre serveur.
Commandes utiles
| Commande | Description |
|---|---|
sudo systemctl restart apache2 | Redémarrer le serveur web |
sudo systemctl status apache2 | Statut d'Apache |
sudo systemctl status mariadb | Statut de la base de données |
sudo dpkg-reconfigure dolibarr | Relancer l'assistant de configuration |
sudo tail -f /var/log/apache2/error.log | Suivre les erreurs Apache/PHP |
Structure des fichiers
| Chemin | Description |
|---|---|
/usr/share/dolibarr/htdocs/ | Code source de l'application |
/etc/dolibarr/conf.php | Fichier de configuration principal |
/etc/dolibarr/install.forced.php | Paramètres imposés à l'installation |
/var/lib/dolibarr/documents/ | Documents, PDF générés, sauvegardes et fichier install.lock |
/var/log/apache2/error.log | Journal des erreurs du serveur web |
Mise à jour de Dolibarr
Pour passer à une version plus récente, téléchargez le nouveau paquet .deb puis installez-le par-dessus l'existant — apt gère la migration :
cd /tmp
wget https://www.dolibarr.org/files/stable/package_debian-ubuntu/dolibarr_NOUVELLE_VERSION_all.deb
sudo apt install ./dolibarr_NOUVELLE_VERSION_all.deb
À la première connexion après une mise à jour, Dolibarr peut demander de lancer un assistant de migration de base de données. Suivez les étapes proposées.
Sauvegardez votre base de données et le dossier /var/lib/dolibarr/documents/ avant toute mise à jour :
sudo mysqldump -u root -p dolibarr > /root/dolibarr_backup.sql
sudo tar czf /root/dolibarr_documents.tar.gz /var/lib/dolibarr/documents
En cas de problème
« Package not found » lors de apt install dolibarr
- Le paquet n'existe plus dans les dépôts : utilisez le fichier .deb officiel comme décrit plus haut.
- Vérifiez que vous préfixez bien le nom par
./ou un chemin absolu.
Erreurs de dépendances à l'installation
- Réparez les dépendances :
sudo apt-get install -f -y - Relancez ensuite la configuration :
sudo dpkg-reconfigure dolibarr
Impossible d'accéder à /dolibarr/
- Vérifiez qu'Apache est démarré :
sudo systemctl status apache2 - Vérifiez que le module PHP est actif :
sudo apachectl -M | grep php - Consultez le journal :
sudo tail -f /var/log/apache2/error.log
Erreur de connexion à la base de données
- Vérifiez que MariaDB/MySQL est démarré :
sudo systemctl status mariadb - Contrôlez les identifiants dans
/etc/dolibarr/conf.php - Testez la connexion :
mysql -u root -p -e "SHOW DATABASES;"
L'assistant d'installation ne s'affiche plus
- Si le fichier
install.lockexiste, l'assistant est verrouillé (comportement normal). Pour le relancer volontairement :sudo rm /var/lib/dolibarr/documents/install.lock(à supprimer uniquement en connaissance de cause).