Introduction : Qu'est-ce que Dolibarr ERP/CRM ?

Dolibarr ERP/CRM est un logiciel open source de planification des ressources d'entreprise (ERP) et de gestion de la relation client (CRM). Il est conçu pour les petites et moyennes entreprises, les freelances, les fondations et les associations. Dolibarr combine simplicité et richesse fonctionnelle, incluant la facturation, la gestion commerciale, la gestion de projets, la gestion de stocks, la comptabilité et les ressources humaines. Contrairement à de nombreuses solutions ERP, Dolibarr est modulaire, permettant aux utilisateurs d'activer uniquement les fonctionnalités nécessaires.

Son interface web permet d'y accéder depuis n'importe quel appareil muni d'un navigateur. Il peut être installé localement sur un ordinateur personnel, sur un serveur, ou utilisé via une solution cloud proposée par des hébergeurs tiers.

Dans ce guide, nous allons suivre pas à pas l'installation et la configuration de Dolibarr.

Prérequis

Avant de commencer l'installation, assurez-vous d'avoir :

• Un serveur ou un ordinateur local sous Linux (Ubuntu), Windows ou macOS

• Serveur web Apache (ou Nginx)

• Base de données MySQL ou MariaDB

• PHP 7.0 ou supérieur

• Accès administrateur pour installer des paquets et modifier les configurations serveur

Configuration serveur recommandée :

• Linux (Ubuntu 20.04+)

• Apache 2.4+

• PHP 8.0+

• MySQL 5.7+ ou MariaDB 10.5+

Pour une installation sous Windows, vous pouvez utiliser XAMPP ou WAMP.

Étape 1 : Téléchargement de Dolibarr

La dernière version stable de Dolibarr peut être téléchargée depuis le site officiel :

• https://www.dolibarr.org/downloads/

Choisissez la version adaptée à votre système d'exploitation. Vous pouvez télécharger le package "standard" pour une installation manuelle ou opter pour les installateurs automatiques pour Windows et macOS.

Pour obtenir la version de développement la plus récente, vous pouvez cloner le dépôt GitHub :

git clone https://github.com/Dolibarr/dolibarr.git

Pour un environnement de production, utilisez uniquement les versions stables.

Étape 2 : Préparation de l'Environnement

Sous Ubuntu/Linux

1. Mettre à jour le système :

sudo apt update && sudo apt upgrade -y

2. Installer Apache, MySQL, PHP et les modules PHP requis :

sudo apt install apache2 mysql-server php php-mysql libapache2-mod-php php-cli php-gd php-curl php-intl php-mbstring php-soap php-xml php-xmlrpc php-zip php-bcmath unzip -y

3. Sécuriser l'installation de MySQL :

sudo mysql_secure_installation

Suivez les instructions pour définir un mot de passe root et supprimer les configurations peu sûres.

4. Créer une base de données pour Dolibarr :

sudo mysql -u root -p
CREATE DATABASE dolibarr CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'dolibarruser'@'localhost' IDENTIFIED BY 'motdepassefort';
GRANT ALL PRIVILEGES ON dolibarr.* TO 'dolibarruser'@'localhost';
FLUSH PRIVILEGES;
EXIT;

5. Déplacer les fichiers Dolibarr dans le répertoire du serveur web :

sudo unzip dolibarr-*.zip -d /var/www/html/
sudo mv /var/www/html/dolibarr-*/ /var/www/html/dolibarr
sudo chown -R www-data:www-data /var/www/html/dolibarr
sudo chmod -R 755 /var/www/html/dolibarr

6. Configurer Apache : Créer un nouveau fichier de configuration pour l'hôte virtuel :

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

Ajouter :

<VirtualHost *:80>
    ServerAdmin admin@example.com
    DocumentRoot /var/www/html/dolibarr/htdocs
    ServerName exemple.com

    <Directory /var/www/html/dolibarr/htdocs>
        Options Indexes FollowSymLinks MultiViews
        AllowOverride All
        Require all granted
    </Directory>

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

Activer le site et le module rewrite :

sudo a2ensite dolibarr.conf
sudo a2enmod rewrite
sudo systemctl reload apache2

7. Accéder à Dolibarr via votre navigateur : Visitez http://votre-ip-serveur/ ou http://votre-domaine/ pour lancer l'assistant d'installation.

Sous Windows (avec XAMPP)

1. Téléchargez et installez XAMPP depuis https://www.apachefriends.org/.

2. Démarrez Apache et MySQL via le panneau de contrôle XAMPP.

3. Placez le dossier Dolibarr dans C:\xampp\htdocs\.

4. Créez une base de données via phpMyAdmin (http://localhost/phpmyadmin).

5. Accédez à http://localhost/dolibarr/htdocs dans votre navigateur.

6. Suivez l'assistant d'installation.

Sous macOS (avec MAMP)

1. Installez MAMP depuis https://www.mamp.info/.

2. Placez les fichiers Dolibarr dans /Applications/MAMP/htdocs/.

3. Démarrez les serveurs MAMP.

4. Créez la base de données Dolibarr via phpMyAdmin.

5. Accédez à http://localhost:8888/dolibarr/htdocs pour commencer l'installation.

Étape 3 : Lancer l'Assistant d'Installation

L'assistant est simple à suivre :

1. Choix de la langue : Sélectionnez votre langue préférée.

2. Vérifications système : L'assistant vérifie votre environnement.

3. Configuration de la base de données :

   • Serveur : localhost

   • Nom de la base : dolibarr

   • Utilisateur : dolibarruser

   • Mot de passe : votremotdepasse

4. Créer les tables : Cliquez sur "Suivant".

5. Compte Administrateur : Définissez votre identifiant et mot de passe admin.

6. Finaliser : Supprimez le répertoire /install pour des raisons de sécurité :

sudo rm -rf /var/www/html/dolibarr/htdocs/install

Étape 4 : Configuration de Base Post-Installation

Après connexion :

Paramétrage de l'Entreprise

Allez dans Accueil > Configuration > Société/Organisation et renseignez :

• Nom de la société

• Adresse

• Pays

• Devise

• Numéro de TVA (si applicable)

• Logo

Activation/Désactivation de Modules

Accédez à Accueil > Configuration > Modules/Applications pour :

• Activer les modules nécessaires (Facturation, Projets, Produits, etc.)

• Désactiver ceux inutiles.

Chaque module peut être configuré spécifiquement.

Gestion des Utilisateurs

• Ajouter des utilisateurs via Accueil > Utilisateurs & Groupes.

• Attribuer les permissions par rôle.

• Créer des groupes pour faciliter la gestion.

Étape 5 : Sécuriser Dolibarr

Quelques bonnes pratiques :

• Forcer le HTTPS : Installez un certificat SSL.

• Mots de passe robustes : Obligatoires pour tous.

• Sauvegardes régulières : Bases et fichiers.

• Accès admin limité : Réservé aux personnes de confiance.

• Mises à jour régulières : Appliquer les correctifs.

Corrigez les permissions :

sudo find /var/www/html/dolibarr/ -type f -exec chmod 644 {} \;
sudo find /var/www/html/dolibarr/ -type d -exec chmod 755 {} \;

Étape 6 : Erreurs Courantes et Corrections

Écran blanc lors de l'installation

• Vérifiez les logs Apache.

• Modules PHP manquants souvent en cause.

Problèmes de connexion à la base

• Contrôlez vos identifiants.

• Assurez-vous que MySQL tourne.

Erreurs de permissions

• Contrôlez propriétaire/fichiers.

Erreur 500

• Problèmes .htaccess.

• Limites PHP mémoire/éxécution à ajuster.

Étape 7 : Optimiser Dolibarr

• Activer le cache Apache.

• Optimiser MySQL (buffers, caches).

• Utiliser un CDN pour les fichiers statiques.

• Limiter les modules activés.

• Nettoyer régulièrement les anciennes données.

Conclusion

Installer et configurer Dolibarr ERP/CRM est simple si l'on suit une méthode structurée. Que vous soyez freelance ou PME en croissance, Dolibarr s'adapte sans complexité inutile.

En suivant ce guide pas à pas, vous disposerez d'une instance Dolibarr pleinement fonctionnelle, prête à accompagner votre activité.

N'oubliez pas : l'installation n'est que le début. Passez du temps sur la configuration, la formation des utilisateurs et la maintenance régulière pour tirer le meilleur de Dolibarr.

Si vous prévoyez une utilisation intensive, pensez à sécuriser votre hébergement ou optez pour un hébergeur professionnel.