Dolibarr est un système ERP et CRM open source robuste et largement utilisé. Il est apprécié pour sa flexibilité, sa simplicité d'utilisation et sa personnalisation pour répondre aux différents besoins des entreprises. Cependant, comme tout logiciel complexe, les utilisateurs peuvent parfois rencontrer des problèmes, l'un des plus alarmants étant l'arrêt soudain de Dolibarr ou son refus total de s'ouvrir.

Que votre Dolibarr soit hébergé localement ou sur un serveur distant, une page blanche ou un message d'erreur peuvent avoir diverses significations. Dans ce guide détaillé, nous explorerons les causes les plus fréquentes de ce problème et vous proposerons des solutions pratiques, étape par étape, pour vous aider à remettre votre système en ligne.

Table des matières

  1. Bilan initial : Dolibarr est-il vraiment en panne ?

  2. Vérification de l'état du serveur Web et du service

  3. Écran blanc de la mort (WSOD)

  4. Erreurs et configurations incorrectes PHP

  5. Échecs de connexion à la base de données

  6. Fichiers corrompus ou manquants

  7. Problèmes d'autorisations et de propriété

  8. Fichier conf.php mal configuré

  9. Problèmes suite à une mise à jour ou une migration récente

  10. Problèmes liés au navigateur ou au cache

  11. Journaux d'erreurs : votre meilleur ami

  12. Utilisation du mode développeur pour déboguer

  13. Stratégies de rétablissement

  14. Mesures préventives

  15. Réflexions finales et recommandations

1. Évaluation initiale : Dolibarr est-il vraiment en panne ?

Avant de vous lancer dans le dépannage technique, commencez par une évaluation rapide :

  • La page se charge-t-elle vraiment ? Ou est-elle complètement vide ?

  • Recevez-vous une erreur HTTP spécifique (par exemple, 403, 404, 500) ?

  • Pouvez-vous accéder directement à la base de données ?

  • Êtes-vous le seul utilisateur à rencontrer ce problème ou est-ce que cela affecte tout le monde ?

Comprendre le contexte permet de cerner le problème. Une panne globale indique des problèmes côté serveur, tandis que des problèmes spécifiques à l'utilisateur peuvent être locaux.

2. Vérification de l'état du serveur Web et du service

Si Dolibarr est auto-hébergé, votre première étape consiste à vérifier si le serveur Web (Apache, Nginx, etc.) et les services associés fonctionnent.

sudo systemctl status apache2
sudo systemctl status nginx
sudo systemctl status mysql

Si l’un de ces services est inactif ou en panne, redémarrez-le :

sudo systemctl restart apache2
sudo systemctl restart mysql

Assurez-vous que votre serveur n’a pas manqué de mémoire ou d’espace disque, ce qui peut entraîner le blocage de ces services.

3. Écran blanc de la mort (WSOD)

Un écran blanc vide sans message d'erreur est souvent appelé « écran blanc de la mort ». Dans les applications PHP comme Dolibarr, il signale généralement une erreur fatale dans le code.

Pour découvrir la cause profonde :

  • Activer le rapport d'erreurs dans conf.php:

$dolibarr_main_prod = 0;

  • Vérifiez les journaux du serveur Web et les journaux PHP

Les écrans vides indiquent presque toujours des inclusions manquantes, des erreurs de syntaxe ou une mise à niveau ayant échoué.

4. Erreurs et configurations PHP

De nombreux problèmes Dolibarr proviennent de problèmes PHP, notamment après les mises à jour.

Les problèmes courants liés à PHP incluent :

  • Versions PHP incompatibles

  • Extensions désactivées (comme pdo_mysql, gd, json)

  • Limites de mémoire trop basses

Corrections:

  • Vérifiez la compatibilité de la version PHP avec votre version Dolibarr

  • Utilisez php -m pour lister les extensions installées

  • modifier php.ini pour augmenter la mémoire :

memory_limit = 512M

Redémarrez le serveur après avoir effectué des modifications.

5. Échecs de connexion à la base de données

Dolibarr s'appuie fortement sur sa base de données MySQL ou PostgreSQL. S'il ne parvient pas à se connecter, l'application ne se chargera pas.

Symptômes:

  • Écran vide sans erreur

  • Message du type « Connexion refusée » ou « Accès refusé »

Ce qu'il faut vérifier :

  • conf.php contient les informations d'identification de base de données correctes

  • Le serveur MySQL est en cours d'exécution

  • L'utilisateur de la base de données dispose des privilèges appropriés

Essayez de vous connecter manuellement via la ligne de commande :

mysql -u dolibarruser -p dolibarrdb

6. Fichiers corrompus ou manquants

Les mises à jour, les pannes de serveur ou les interruptions de transfert de fichiers peuvent corrompre les fichiers.

Vérifier:

  • Comparez vos fichiers Dolibarr actuels à une copie propre

  • Rechercher des fichiers partiellement téléchargés ou des tailles de fichiers incorrectes

Solution:

  • Re-télécharger une copie propre de Dolibarr (sauf conf.php et /documents)

  • Vérifiez .htaccess et dossiers de modules

7. Problèmes d'autorisations et de propriété

Des autorisations de fichiers incorrectes sont une cause fréquente de problèmes, en particulier après une migration ou une mise à jour manuelle.

Autorisations recommandées :

chown -R www-data:www-data /var/www/dolibarr
find /var/www/dolibarr -type f -exec chmod 644 {} \;
find /var/www/dolibarr -type d -exec chmod 755 {} \;

Ajustez l'utilisateur/groupe en fonction de la configuration de votre serveur.

8. Fichier conf.php mal configuré

L' conf.php fichier dans /htdocs/conf/ est critique. Si son contenu est modifié ou supprimé, Dolibarr ne se chargera pas.

Vérifier:

  • Corriger les informations d'identification de la base de données

  • Chemins appropriés (surtout si vous avez déplacé des serveurs)

  • Syntaxe PHP valide (points-virgules manquants, etc.)

Modifiez toujours ce fichier à l’aide d’un éditeur de code et non d’un traitement de texte.

9. Problèmes suite à une mise à jour ou une migration récente

De nombreuses pannes de Dolibarr surviennent juste après une mise à niveau de version ou une migration de serveur.

Causes:

  • Téléchargements de fichiers incomplets

  • Étapes de mise à niveau de la base de données ignorées

  • Incompatibilités de modules

Correction:

  • Cliquez sur /install/ et terminez l'assistant de mise à niveau

  • Réexécutez les scripts de mise à niveau SQL manuellement si nécessaire

  • Déplacer les modules incompatibles hors du custom/ dossier

10. Problèmes liés au navigateur ou au cache

Parfois, Dolibarr peut fonctionner correctement, mais votre navigateur affiche une erreur en cache.

Solutions:

  • Effacer le cache du navigateur

  • Utiliser le mode navigation privée

  • Essayez d'accéder à partir d'un autre navigateur ou appareil

Vous pouvez également vider le cache du serveur si vous avez implémenté un proxy inverse ou une couche de mise en cache.

11. Journaux d'erreurs : votre meilleur ami

Les journaux d'erreurs contiennent souvent la cause exacte du problème. Vérifiez :

  • Journaux Apache : /var/log/apache2/error.log

  • Journaux PHP : en fonction de votre php.ini config

  • Journal Dolibarr : /documents/dolibarr.log

Recherchez des entrées récentes avec des messages « Fatal », « Erreur » ou « Avertissement ».

12. Utilisation du mode développeur pour déboguer

Paramètres $dolibarr_main_prod = 0; dans votre conf.php le fichier affichera les erreurs PHP directement dans le navigateur, facilitant ainsi le débogage.

Utilisez-le uniquement temporairement dans un environnement sécurisé, pas sur un serveur public.

Vous pouvez également installer des outils de débogage comme Xdebug pour parcourir le code si nécessaire.

13. Stratégies de récupération

Si les correctifs standards ne fonctionnent pas, pensez à ceux-ci :

  • Restaurer une sauvegarde récente: L'option la plus fiable si vous avez un bon instantané

  • Configurer une nouvelle installation de Dolibarr et migrer la base de données vers celle-ci

  • Embaucher un professionnel si le problème est complexe et critique pour l'entreprise

Disposer d’un plan de réponse aux temps d’arrêt vous aidera à agir rapidement et à minimiser l’impact.

14. Mesures préventives

Prévenez les incidents futurs en :

  • Sauvegarde régulière des fichiers et de la base de données

  • Utilisation du contrôle de version pour les modules personnalisés

  • Tester d'abord les mises à jour dans un environnement de test

  • Surveillance de l'espace disque et des performances

  • Restreindre l'accès au serveur au personnel de confiance

Ces habitudes contribuent grandement au maintien d’un système Dolibarr sain.

15. Réflexions finales et recommandations

Lorsque Dolibarr cesse de s'ouvrir, on peut avoir l'impression que tout votre système d'entreprise est bloqué. Mais la plupart des causes sont identifiables et peuvent être résolues grâce à un processus de dépannage structuré.

Commencez par les bases (vérifications du serveur et des services), puis passez aux fichiers de configuration, aux journaux d'erreurs et aux paramètres PHP. Assurez-vous que votre installation soit propre, modulaire et bien documentée.

Et surtout, préparez-vous aux imprévus. Avec une stratégie préventive adaptée, vous garantirez le bon fonctionnement de Dolibarr lorsque vous en aurez le plus besoin.