Dolibarr est un logiciel de Gestion des Ressources d’Entreprise (ERP) et de Gestion de la Relation Client (CRM) open-source populaire qui peut être installé sur des systèmes Linux. Il offre une large gamme de fonctionnalités pour la gestion des entreprises, notamment la comptabilité, la facturation, la gestion de projet, la gestion des stocks et bien plus encore. Dans ce guide complet, nous vous guiderons étape par étape à travers le processus d’installation de Dolibarr sur un système Linux.
Prérequis
Avant de commencer, assurez-vous d’avoir les prérequis suivants en place :
- Système d’exploitation Linux : Dolibarr peut être installé sur diverses distributions Linux, comme Ubuntu, Debian, CentOS ou Fedora. Dans ce guide, nous utiliserons Ubuntu 20.04 LTS comme exemple.
- Serveur Web : Dolibarr nécessite un serveur web pour fonctionner, vous devrez donc avoir Apache ou Nginx installé sur votre système Linux.
- Serveur de base de données : Dolibarr utilise une base de données pour stocker ses données, vous devrez donc avoir un serveur de base de données installé, comme MySQL ou MariaDB.
- PHP : Dolibarr est construit à l’aide de PHP, vous devrez donc avoir PHP installé sur votre système.
Étape 1 : Installer les paquets requis
Mettre à jour l’index des paquets :
$ sudo apt-get update
Installer le serveur web Apache :
$ sudo apt-get install apache2 -y
Installer le serveur de base de données MariaDB :
$ sudo apt-get install mariadb-server mariadb-client -y
Installer PHP et les modules requis :
$ sudo apt-get install php libapache2-mod-php php-mysql php-gd php-curl php-zip php-mbstring php-xml php-intl -y
Redémarrer Apache :
$ sudo systemctl restart apache2
Étape 2 : Sécuriser la base de données MariaDB
Exécuter le script d’installation sécurisée de MySQL :
$ sudo mysql_secure_installation
Ce script vous invitera à définir un mot de passe root pour la base de données MariaDB, et il supprimera également certains paramètres par défaut non sécurisés.
Se connecter à la console MariaDB :
$ sudo mysql -u root -p
Entrez le mot de passe root que vous avez défini à l’étape précédente.
Créer la base de données et l’utilisateur Dolibarr :
CREATE DATABASE dolibarr;
CREATE USER 'dolibarr'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON dolibarr.* TO 'dolibarr'@'localhost';
FLUSH PRIVILEGES;
EXIT;
Remplacez 'your_password'
par un mot de passe fort et unique pour l’utilisateur Dolibarr.
Étape 3 : Télécharger et extraire Dolibarr
Télécharger la dernière version de Dolibarr :
$ wget https://github.com/Dolibarr/dolibarr/archive/refs/tags/19.0.0.tar.gz
Cela téléchargera la dernière version stable de Dolibarr (19.0.0 dans cet exemple).
Extraire l’archive téléchargée :
$ sudo tar -xzf 19.0.0.tar.gz -C /var/www/html/
Cela extrait les fichiers Dolibarr dans le répertoire /var/www/html/
.
Renommer le répertoire extrait :
$ sudo mv /var/www/html/dolibarr-19.0.0 /var/www/html/dolibarr
Cela renomme le répertoire extrait en dolibarr
, ce qui facilitera l’accès à l’installation de Dolibarr.
Définir les autorisations correctes :
$ sudo chown -R www-data:www-data /var/www/html/dolibarr
$ sudo chmod -R 755 /var/www/html/dolibarr
Ces commandes définissent les bons propriétaires et autorisations pour le répertoire et les fichiers Dolibarr.
Étape 4 : Configurer le serveur web Apache
Créer un fichier de configuration de l’hôte virtuel :
$ sudo nano /etc/apache2/sites-available/dolibarr.conf
Ajoutez le contenu suivant au fichier :
<VirtualHost *:80>
ServerName dolibarr.example.com
DocumentRoot /var/www/html/dolibarr/htdocs
<Directory /var/www/html/dolibarr/htdocs>
Options FollowSymLinks
AllowOverride All
Require all granted
</Directory>
ErrorLog ${APACHE_LOG_DIR}/dolibarr-error.log
CustomLog ${APACHE_LOG_DIR}/dolibarr-access.log combined
</VirtualHost>
Remplacez dolibarr.example.com
par votre nom de domaine souhaité.
Activer l’hôte virtuel :
$ sudo a2ensite dolibarr.conf
Redémarrer Apache :
$ sudo systemctl restart apache2
Étape 5 : Terminer l’installation de Dolibarr
Ouvrir la page d’installation de Dolibarr :
Dans votre navigateur web, accédez à http://dolibarr.example.com/install/
. Remplacez dolibarr.example.com
par votre nom de domaine ou adresse IP réelle.
Suivre l’assistant d’installation de Dolibarr :
- Sur la première page, cliquez sur “Démarrer” pour commencer le processus d’installation.
- Sur la page de configuration, saisissez les détails de connexion à la base de données :
- Nom de la base de données :
dolibarr
- Utilisateur de la base de données :
dolibarr
- Mot de passe de la base de données : le mot de passe que vous avez défini précédemment
- Nom de la base de données :
- Créez un compte d’utilisateur super-administrateur Dolibarr et cliquez sur “Étape suivante” pour continuer.
- Passez en revue le résumé de l’installation et cliquez sur “Étape suivante” pour terminer l’installation.
Sécuriser l’installation :
Pour empêcher tout accès non autorisé à l’installation de Dolibarr, créez un fichier de verrouillage d’installation :
$ sudo touch /var/www/html/dolibarr/documents/install.lock
Ce fichier empêchera quiconque d’accéder à nouveau à l’assistant d’installation.
Félicitations ! Vous avez réussi à installer Dolibarr ERP/CRM sur votre système Linux. Vous pouvez maintenant vous connecter à l’interface web de Dolibarr en utilisant le compte super-administrateur que vous avez créé pendant le processus d’installation.
Mise à jour de Dolibarr
Pour mettre à jour Dolibarr vers une nouvelle version, suivez ces étapes :
Sauvegarder les données Dolibarr :
Avant de procéder à la mise à jour, il est essentiel de créer une sauvegarde des données Dolibarr, y compris la base de données et toutes les configurations ou fichiers personnalisés.
Télécharger la dernière version de Dolibarr :
$ wget https://github.com/Dolibarr/dolibarr/archive/refs/tags/19.0.1.tar.gz
Remplacez le numéro de version par la dernière version stable.
Extraire l’archive téléchargée :
$ sudo tar -xzf 19.0.1.tar.gz -C /var/www/html/
Renommer le répertoire extrait :
$ sudo mv /var/www/html/dolibarr-19.0.1 /var/www/html/dolibarr
Définir les autorisations correctes :
$ sudo chown -R www-data:www-data /var/www/html/dolibarr
$ sudo chmod -R 755 /var/www/html/dolibarr
Effacer le cache et les journaux :
$ sudo rm -rf /var/www/html/dolibarr/documents/cache/*
$ sudo rm -rf /var/www/html/dolibarr/documents/logs/*
Redémarrer Apache :
$ sudo systemctl restart apache2
C’est tout ! Votre installation de Dolibarr a été mise à jour vers la dernière version. N’oubliez pas de tester votre installation de Dolibarr mise à jour de manière approfondie avant de la mettre en production.
Dépannage
Si vous rencontrez des problèmes lors de l’installation ou de l’utilisation de Dolibarr, voici quelques étapes de dépannage courantes que vous pouvez essayer :
Vérifier les journaux d’erreurs Apache :
$ sudo tail -n 50 /var/log/apache2/error.log
Cela vous montrera les 50 dernières lignes du journal d’erreurs Apache, qui peuvent vous donner des indices sur le problème que vous rencontrez.
Vérifier les journaux Dolibarr :
$ sudo tail -n 50 /var/www/html/dolibarr/documents/logs/dolibarr.log
Le fichier journal Dolibarr peut contenir des informations plus spécifiques sur les erreurs ou les problèmes que vous rencontrez.
Vérifier la connexion à la base de données :
$ sudo mysql -u dolibarr -p
Connectez-vous à la console MariaDB et assurez-vous que la base de données et l’utilisateur Dolibarr sont correctement configurés.
Vérifier le fichier de configuration Dolibarr :
$ sudo nano /var/www/html/dolibarr/htdocs/conf/conf.php
Vérifiez que les détails de connexion à la base de données dans le fichier de configuration Dolibarr sont corrects.
Rechercher de l’aide dans la communauté :
Si vous n’arrivez pas à résoudre le problème par vous-même, n’hésitez pas à demander de l’aide à la communauté Dolibarr. Vous pouvez publier votre question sur les forums Dolibarr ou contacter l’équipe de développement Dolibarr pour obtenir de l’assistance.
En suivant les étapes décrites dans ce guide et en résolvant les éventuels problèmes qui surviendraient, vous devriez pouvoir installer et configurer avec succès Dolibarr ERP/CRM sur votre système Linux.