Déployer Dolibarr : template FAQ avec intégrations modernes

Version 2025 – Guide complet pour les équipes IT et fonctionnelles

1. Introduction

Dolibarr est un ERP/CRM open‑source à la fois simple et puissant, idéal pour les PME, les associations ou les équipes qui souhaitent gérer leurs ventes, achats, stocks, comptes et relations clients sans dépendre d’une solution commerciale onéreuse.

Ce document vous propose un guide de déploiement ainsi qu’un modèle de FAQ modernisé incluant les principales intégrations (API, paiement en ligne, CRM, etc.) qui transforment Dolibarr en véritable hub numérique.

2. Architecture de déploiement recommandée (2025)

Environnement Tecnologies Pourquoi
Serveur de production Docker + Compose, Ubuntu 22.04 LTS, PostgreSQL 15, Nginx Isolation, scalabilité, facile à mettre à jour via les images officielles.
Sauvegardes automatisées Restic + Cron, stockage S3 (ou Wasabi) Sauvegarde incrémentale chiffrée, restauration testée.
Monitoring & alerting Prometheus + Grafana, alerts Slack/Telegram Suivi de latence, utilisation CPU/IO, déclencheurs d’incidents.
CI/CD GitLab CI / GitHub Actions Déploiement zéro‑downtime (rolling update).
Sécurité Let’s Encrypt, fail2ban, config HTTPS strict (HSTS, CSP) Protection contre les vulnérabilités web, conformité RGPD.

2.1. Schéma d’installation (Docker‑Compose)

version: '3.8'

services:

  db:

    image: postgres:15-alpine

    environment:

      POSTGRES_DB: dolibarr

      POSTGRES_USER: dolibarr

      POSTGRES_PASSWORD: ${DB_PASSWORD}

    volumes:

      - db_data:/var/lib/postgresql/data
dolibarr:

    image: dolibarr/dolibarr:latest

    depends_on:

      - db

    environment:

      DBHOST: db

      DBNAME: dolibarr

      DBUSER: dolibarr      DBPASSWD: ${DB_PASSWORD}

    ports:

      - "8080:80"

    volumes:

      - dolibarr_data:/var/www/dolibarr/htdocs

    restart: unless-stopped
volumes:

  db_data:

  dolibarr_data:

Astuce : Utilisez le mode « debounce » de Dolibarr ($addrpal = 'https://yourdomain.com') pour que toutes les URL générées contiennent le bon domaine, même derrière un reverse‑proxy.

3. Intégrations modernes

Dolibarr propose aujourd’hui plus de 30 modules d’extension officiels, mais les besoins actuels vont bien au‑delà. Voici les intégrations modernes les plus populaires, classées par catégorie :

3.1. Paiement en ligne & facturation digitale

Module Fonctionnalités Compatibilité
PayPlug Paiements cartes, SEPA, 3DS, webhook de confirmation API REST, webhook sécurisé
Stripe Paiement mobile, abonnement, gestion de refacturations SDK Stripe PHP, webhook async
PaySharp Paiement mobile africain (Mobile Money) REST + QR code

Implémentation : Créez un module « /custom/payplug » où vous exposez un point d’entrée /webhook qui renvoie un statut ok à PayPlug et met à jour la commande (`statut = ‘payé’).

3.2. API & micro‑services

API Cas d’usage Exemple d’appel
REST JSON (core) Synchronisation avec CRM, ERPs externes GET /prod/api.php?mode=get object list
GraphQL (module GraphQL community) Interrogation sélective des champs query { customers { id name } }
Webhooks Réaction instantanée (ex. création facture → Slack) POST /dolibarr/core/modules/order/webhook.php

Tip : Utilisez FastAPI ou Express pour créer un gateway API qui masque les endpoints internes de Dolibarr et ajoute une couche d’authentification OAuth2.

3.3. CRM & Social Media| Solution | Points forts | Intégration |

|———-|————-|————-|
| HubSpot | Gestion contacts, email tracking, pipelines | Zapier / Integromat + Webhooks |
| MailerLite | Campagnes email, automatisation | API email‑templates |
| WhatsApp Business API | Notifications transactionnelles | Twilio + libcurl wrapper |

3.4. Monitoring & Stats en temps réel

Outil Méthode Exemple
Matomo Tracking des tickets support Piwik Tag intégré dans le front
Grafana + Loki Logs d’erreurs, métriques DB Promtail → Loki → Grafana
Matomo Matomo Cloud Heatmaps, funnel conversion Script de suivi dans les template HTML

4. Modèle de FAQ moderne

Le format de cette FAQ reprend les meilleures pratiques :
• Questions concises, structurées (H2/H3).
• Réponses actionnables avec code ou capture d’écran.
• Annexes de liens utiles (docs, tickets GitHub).
• Version multilingue (FR/EN) accessible via le sélecteur en haut à droite.

4.1. Comment déployer Dolibarr avec Docker ? Question : Je veux installer Dolibarr en local sans toucher à mon serveur Apache existant. Quelle commande Docker dois-je exécuter ?

Réponse : « `bash

mkdir -p ~/dolibarr/data && cd ~/dolibarr

cat > docker-compose.yml <<‘EOF’

EOF

docker compose up -d



> **Tip :** Ajoutez `--restart unless-stopped` à chaque service pour un redémarrage automatique après un reboot.
---
### 4.2. Où placer les fichiers de personnalisation (templates, modules) ?  
**Question :** *Je dois ajouter un module « Facturation PDF avancée ». Où doit‑être installé le fichier PHP ?*  
**Réponse :**  - Créez le répertoire `custom/<module_name>/` dans le volume partagé `/var/www/dolibarr/htdocs/custom/`.  

- Placez le fichier `myinvoice.class.php` à l’intérieur.  

- Dans *Setup → Modules*, activez le module et indiquez le chemin `custom/<module_name>/myinvoice.class.php`.  ---
### 4.3. Comment sécuriser l’accès à l’interface admin ?  
**Question :** *Quel mécanisme simple permet de bloquer l’accès à `/admin` depuis Internet ?*  
**Réponse :**  

1. Créez un **reverse‑proxy Nginx** avec une règle d’IP :  
```nginx

   location /admin {

       allow 192.168.0.0/16;   # votre réseau interne

       deny all;

       include proxy_params;

       proxy_pass http://dolibarr:80;

   }

  1. Activez HTTP Basic Auth pour les accès externes :

    auth_basic "Accès admin restreint";
    
auth_basic_user_file /etc/nginx/.htpasswd;

4.4. Quelle est la méthode recommandée pour synchroniser les clients avec HubSpot ? Question : Je veux que chaque nouveau contact Dolibarr crée un contact HubSpot automatiquement. Quelle API dois‑je appeler ?

Réponse : 

// Exemple d’appel cURL depuis un script cron (tous les 15min)

$url = 'https://api.hubapi.com/contacts/v1/contact';

$ch = curl_init($url);

curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([

    'properties' => [

        'email'   => $dolibarrContact['email'],

        'firstname' => $dolibarrContact['firstname'],

        'lastname'  => $dolibarrContact['lastname']

    ]

]));

curl_setopt($ch, CURLOPT_HTTPHEADER, [

    'Authorization: Bearer ' . $_ENV['HUBSPOT_TOKEN'],

    'Content-Type: application/json'

]);

curl_exec($ch);

Astuce : Stockez le token dans le secret manager (Vault, AWS Secrets Manager) pour éviter les fuites.

4.5. Comment envoyer un e‑mail de rappel de paiement via Slack ?

Question : Lorsqu’une facture atteint le statut « En attente » depuis plus de 7 jours, je veux envoyer un rappel dans le canal #payments. Quelle intégration ?

Réponse : 1. Webhook Slack dans le module Message : 

   $payload = [

       'text' => "*Rappel paiement* : ".$facture['ref'].

                 "\nClient : ".$client['name'].

                 "\nMontant : ".$facture['total'].

                 "\nÉchéance : ".$facture['date_limite']

   ];

   file_get_contents('https://hooks.slack.com/services/XXXXX/XXXXX/XXXXX', false, stream_context_create([

       'http' => [

           'method'  => 'POST',

           'header'  => "Content-type: application/json\r\n",

           'content' => json_encode($payload)

       ]

   ]));

  1. Cron : */30 * * * * php /var/www/dolibarr/htdocs/cron/trigger_reminder.php

4.6. Puis‑je créer une API GraphQL pour exposer les devis ?

Question : J’ai besoin d’un endpoint GraphQL que notre application mobile consomme pour afficher les devis. Dolibarr le possède‑t‑il déjà ?

Réponse :
Oui, le module graphql (disponible depuis la version 9.0) expose un endpoint /graphql. Exemple de requête : 

query {

  salesInvoiceList(filter: {status: "Draft"}) {

    id

    label

    total_taxs

    line {

      label

      amount

    }

  }

}

Réponse JSON : { "data": { "salesInvoiceList": [ { "id":"12", "label":"DEV-2025-001", ... } ] } }

4.7. Quelle est la procédure de migration de MySQL vers PostgreSQL ?

Question : Nous migrons la base de données de MySQL (Dolibarr 9.0) vers PostgreSQL 15. Quels sont les étapes critiques ?

Réponse : 1. Dump MySQL : mysqldump -u root -p dolibarr > dump.sql

  1. Créez la base PostgreSQL : CREATE DATABASE dolibarr; CREATE USER dolibarr WITH ENCRYPTED PASSWORD 'pwd';

  2. Convertissez le schema avec pgloader :

    bash pgloader dump.sql postgresql://dolibarr:pwd@localhost:5432/dolibarr?schema=public

  3. Vérifiez les contraintes : SELECT tablename FROM pg_constraints WHERE conname NOT LIKE 'pg_%';

  4. Mettez à jour dolibarr.conf.php avec les nouvelles credenciales PostgreSQL. > Note : Testez la migration sur un environnement de staging avant de passer en production.

5. Checklist de déploiement (version 2025)

✅ Action Responsable Échéance
1 Provisionner serveur (VM ou Cloud) Ops J+0
2 Installer Docker, Docker‑Compose Admin Sys J+0
3 Déployer docker-compose.yml DevOps J+1
4 Configurer HTTPS avec Let’s Encrypt SecOps J+2
5 Activer le module PayPlug et tester le webhook Finance J+3
6 Créer le module Slack → Rappel paiement IT J+4
7 Mettre en place les backups incrémentaux Admin Sys J+5
8 Configurer monitoring (Prometheus/Grafana) SecOps J+6
9 Rédiger la FAQ interne et la publier Support J+7
10 Audit sécurité (OWASP) SecOps J+14
11 Re‑déployer en prod (rolling update) DevOps J+15

6. Ressources complémentaires

Type Lien Description
Documentation officielle https://www.dolibarr.org/en/doc/ Guides d’installation, configuration, API.
Docker Hub https://hub.docker.com/r/dolibarr/dolibarr Images officielles, tags latest et 9.0.
Module GraphQL https://github.com/Dolibarr/graphql Exemple de schéma et resolver.
Webhook Sample https://github.com/Dolibarr/webhooks Implémentations PayPlug, Stripe, MailerLite.
FAQ en ligne (multilingue) https://faq.dolibarr.org/ Questions fréquentes et réponses officielles.
Blog de bonnes pratiques https://blog.dolibarr.org/ Articles sur le scaling, CI/CD, sécurité.

7. Conclusion

Deployer Dolibarr aujourd’hui ne se limite plus à un simple apt-get install dolibarr. En 2025, l’écosystème autour de l’ERP open‑source s’appuie sur Docker, des API modernes (REST, GraphQL, Webhooks), et des intégrations tierces (paiement, CRM, monitoring).

Cette documentation vous a fourni :

  1. Une architecture de déploiement prête à l’emploi (Docker‑Compose + bonnes pratiques de sécurité).

  2. Une cartographie des intégrations modernes pour automatiser vos flux financiers, CRM et reporting.

  3. Un modèle de FAQ moderne que vous pouvez copier‑coller dans votre intranet ou votre centre d’aide, avec réponses concrètes, code et liens utiles.

En suivant les étapes, la checklist et les bonnes pratiques exposées, votre instance Dolibarr sera robuste, évolutive et parfaitement alignée avec les exigences numériques contemporaines.

Bonne mise en œuvre ! 🚀

À retenir : Documentez chaque intégration dans votre FAQ afin de garantir la traçabilité et de faciliter le support post‑déploiement.

Publications similaires