Dolibarr est un ERP + CRM open‑source qui a gagné le cœur des petites et moyennes entreprises (PME) depuis sa création. La mise en place d’une solution modulaire et évolutive comme Dolibarr peut sembler ardue, mais en suivant quelques bonnes pratiques, vous éviterez bien des pièges et profiterez pleinement de l’écosystème.
1. Pourquoi Dolibarr ? Une vision courte mais précise
| Avantage | Description | Pourquoi vous en avez besoin |
|---|---|---|
| Modularité | Chaque fonction (ventes, achats, inventaire, facturation, RH, etc.) est un module indépendant. | Chauffez‑ou‑refroidz votre ERP en fonction de vos besoins réels. |
| Simplicité d’installation | 1‑click via Docker, Debian, Ubuntu, etc. | Démarrer rapidement sans expertise serveur lourde. |
| Open‑source & communauté active | Code libre, forums, GitHub, Liste de diffusion. | Pas de coûts de licence, plus de flexibilité à l’intégration. |
| Multilingue & multidevises | Gestion native. | Opération internationale sans bousculer la configuration. |
| Intégration API | REST ou SOAP. | Connectez vos ERP à des applications externes facilement (Shop‑aspirin, ERP, e‑commerce). |
2. Configuration initiale : positifs à verrouiller
| Étape | Astuce | Pourquoi | |
|---|---|---|---|
| Choisir un domaine dédié | erp.mondomaine.com |
Sépare l’ERP du reste du site pour la sécurité. | |
| HTTPS par défaut | Utiliser Let’s Encrypt + force HTTPS | Evite les attaques “man‑in‑the‑middle” et protège les logs. | |
| Index de base | mysqld --rc-file=mysqld‑opt‑conf |
Ajuster innodb_buffer_pool_size à 60 % de RAM si uniquement Dolibarr |
|
| Gestion de groupe d’utilisateurs | sudo useradd -r -s /bin/false dolibarr && chown -R dolibarr:dolibarr /opt/dolibarr |
Limiter les permissions, sécuriser le serveur. |
Expert du jour – Philippe H., ingénieur Sofware, Dolibarr Corp.
“ La première règle est de séparer le dossier d’installation du dossier de configuration. Cela limite les risques lors d’une mise à jour. ”
3. Modules indispensables pour une PME
| Module | Fonction | Astuce d’implémentation |
|---|---|---|
| Facturation (mod_dolibarr) | Émettre, suivre factures | Utiliser le modèle “Facture + remise + TVA” pour automatiser les calculs. |
| Gestion des contacts (mod_contact) | CRM | Synchroniser via un webhook vers votre base GSuite. |
| Inventaire (mod_stock) | Suivi des stocks | Activer Paramètre avancé → Outils → Gestion de l’alerte niveau stock |
| Achats (mod_fournisseur) | Quotations & fournisseurs | Lier le formulaire d’achat à l’équipe ERP via les droits d’accès. |
| Projets (mod_project) | Gestion Agile | Activer la vue Kanban pour la montée en compétence de l’équipe. |
| Paiements (mod_payment) | Intégration Paiement | Choisir un gateway (Stripe, PayPal) et tester via sandbox. |
Mise en pratique – Cédric M., directeur financier
“ La stack « Facturation + Inventaire + Crédit » est devenue notre combiné gagnant; nous économisons 30 % du temps comptable quotidien. ”
4. Personnalisation avancée
4.1 Filtres et rapports personnalisés
- Créez un rapport PDF sur le module
mod_statementsen copiant le fichiertpl_table_row.css. - Ajoutez un champ custom dans la JSON d’un objet via modCustomFieldFactory.
4.2 Thème & UI
- Utilisez le template Bootstrap 4 avec la librairie
dolibarr/includes/libpour un UI moderne. - Modifier
theme.css:.dolibarr-header { background:#00539C; }
.dolibarr-link:hover {color:#FF8800;}
4.3 Étendre le back‑office
- Hook :
lib/entity/class/dolibarr_api.class.phppour intercepter les appels API. - Back‑end : écrire un modulo sous
htdocs/custom/mycustommoduleet déclarer le formulairemycustommodule_setup.php.
Conseil du développeur – Marie D., freelance
“ Faire un custom hook pour la facturation évite de surcharger les tables natives. Cette approche est plus maintenable quand les futures mises à jour arrivent. ”
5. Optimisations de performance
| Point | Astuce | Bénéfice |
|---|---|---|
| Cache | Activer Redis ou Memcached pour Caching HTTP & SQL. | Réduit la charge de la base de données. |
| Compression | Modifiez php.ini : gzip = On. |
Diminue la largeur de bande. |
| Index | Ajoutez un index sur fk_soc, ref dans la table llx_invoice. |
Améliore les requêtes SELECT. |
| Lazy Load | Déconnectez mod_no_milib pour éviter milib on demand. |
Moins de ressources chargées. |
Stat – Système d’information de 200 clients
“Avant l’implémentation Redis, les temps moyens de réponse des factures passaient de 3.5s à 0.8s. Cela a réduit le taux de rebond sur le portail de facturation de 15 %. ”
6. Sécurité, chaque terrible
| Pratique | Pourquoi |
|---|---|
| Mises à jour régulières | 150 + de bugs corrigés chaque release. |
| Gestion des accès | Utiliser admin + rôles ACX, ARX. |
| Audit | Activer le module mod_audit et reporter les IP suspicious. |
| Encryption | imap-latest.ssf + openssl pour stocker les clés. |
| Back‑ups | Cron job nightly, stocker hors site via rsync -av /opt/dolibarr /mnt/backup + chiffrement GPG. |
Patrimoine – Boosters Security
“Dans les tests, notre système a résisté à 2 attaques de type injection SQL sans aucune faille grâce à une configuration stricte sur les paramètressql_modeetsafe_mode. ”
7. Sauvegarde & restauration – Le but est simple
| Étape | Commande | Astuce |
|---|---|---|
| Backup DB | mysqldump -u root -p dolibarr > /backup/dolibarr_$(date +%F).sql |
Combinez avec compression gzip. |
| Backup fichiers | tar -czf /backup/dolibarr_files_$(date +%F).tar.gz /opt/dolibarr |
Excluez htdocs/custom/tmp. |
| Restauration | mysql -u root -p dolibarr < /backup/dolibarr_YYYY-MM-DD.sql |
Vérifier l’intégrité via mysqlcheck. |
Pratique – SLang & Solil
“Répartir les sauvegardes sur trois médias (NAS, Cloud, Papier) assure la redondance, gage de votre S.O.S. gestionnaire de crise. ”
8. Intégrations externes – Open‑API = liberté
8.1 API REST
curl -X POST "https://erp.mondomaine.com/api/index.php" \
-H "HTTP_AUTHENTICATION: userkey:xxxx" \
-d '{"socid":1,"amount":1000,"date":"2025-09-23"}'8.2 Webhooks
- Ajoutez sur mod_clickhouse un webhook vers votre CRM pour déclencher une campagne de relance.
- Exemple Python :
def update_contact(email, status):
payload = {"email": email, "status": status}
requests.post("https://crm.mondomaine.com/api/contacts", json=payload)8.3 Connecteurs communs
| Service | Type | Astuce |
|---|---|---|
| Stripe | Payment | Utiliser le module mod_directpayment + Webhook event.customer.subscription.updated. |
| Shopify | e‑commerce | Plugin mod_ecom + import automatique de commandes. |
| Google Sheets | Feuille de calcul | Webhook PHP mod_wdf pour synchroniser des KPI. |
9. Déploiement multi‑sites & haute disponibilité
| Méthode | Outil | Points clés |
|---|---|---|
| Docker Compose | docker-compose.yml |
Chaque service (php, mysql, redis) en conteneur séparé. |
| Kubernetes | Helm Chart | Échelle horizontale via ReplicaSets. |
| Puppet / Ansible | Configuration as code | Gérer 5 environnements distincts (dev, test, prod). |
| Load Balancer | HAProxy | Routage vers le noeud actif. |
Note d’expert – Jean-Luc R., sysadmin
“La clé est d’avoir une seule base de données par instance pour éviter l’éclatement de données. Si vous avez besoin de partager seulement quelques tables, utilisez des synonymes post‑Mongo ou un système de réplication. ”
10. Formation & support – Le facteur humain
| Ressource | Type | Recommandation |
|---|---|---|
| Documentation officielle | PDF & Web | Toujours la version 3.0 (actuelle) pour vermeiden de suivre des vieux guides. |
| Forum communautaire | Discussion | Rechercher “Astuces” puis filtrer par tag “Deploy” ou “Customizations”. |
| YouTube | Vidéos | “Dolibarr 3.0 – Guide d’installation” par le canal officiel. |
| Bibliothèque de code | GitHub | Reprendre des modules custom/ pour un travail sur mesure. |
| Formation interne | Atelier | 4 sessions 2 h chacune : 1) Installation, 2) Modules essentiels, 3) Custom. 4) Sécurité avancée. |
Encadrement – Mickaël P., formateur ERP
“Mettre en place une roadmap de formation sur 3 mois permet de consolider les acquis et d’éviter les détours inutiles. ”
11. Contribuer à la communauté – Gagner du prestige
- Forker le dépôt officiel (
github.com/Dolibarr/dolibarr). - Apporter un module minimal (<200 ligne) pour une fonction courante inexistante.
- Rédiger une issue descriptive, tag “enhancement” + “prio:normal”.
- Créer une pull request (PR) détaillée.
- Participer aux review et aux chat Slack #dolibarr-dev.
Inscription – Nom
“Une fois contribution approuvée, votre nom s’ajoute à la page Contributors. C’est un gage de crédibilité pour votre PME. ”
12. Conclusion – Vers une utilisation maîtrisée
« Dolibarr est un couteau suisse : il faut savoir découdre la partie « feuille » pour tirer le meilleur parti de chaque lame. » – Bernard L., consultant ERP
En appliquant ces astuces de configuration, de personnalisation et de sécurisation, vous transformerez un simple ERP en un véritable levier de productivité. N’oubliez pas que la réussite d’un déploiement Dolibarr se mesure autant à la qualité de son code qu’à la formation des employeurs et à la robustesse de la gouvernance des données. Alors, lancez‑vous, explorez l’API, testez les modules, et surtout, profitez d’une communauté toujours prête à vous soutenir.
Bonne route ! 🚀