Notes techniques
Des cas rencontrés sur des installations Dolibarr, avec la cause, la vérification faite et la sortie. Rien n’y est publié qui n’ait été relu dans le code ou rejoué sur une instance de test. Il n’y a pas de rythme de publication promis : il y a 50 notes.
Après une mise à jour de Dolibarr, mes chiffres ou mes écrans ont changé : ce qui change de la 21 à la 24
Chiffre d'affaires différent après la mise à jour, facture qui ne repasse plus en brouillon, champ disparu : les changements de comportement de Dolibarr 22, 23 et 24 qui surprennent les utilisateurs, testés version par version, avec le réglage qui rétablit l'ancien fonctionnement quand il existe.
· Dolibarr 23.0.4 et 24.0.2 (testés le 04/11/2026), comparés à 22.0.5Corriger une facture validée dans Dolibarr 23 et 24 : quand « Modifier » marche encore, et l'avoir sinon
Depuis la version 23, une facture validée ne repasse plus toujours en brouillon. Ce qui la bloque, ce qu'on peut encore changer sans y toucher, et la correction par avoir puis nouvelle facture, testée sur Dolibarr 24.0.2 et 23.0.4.
· Dolibarr 24.0.2 et 23.0.4 (testés le 04/11/2026)Modèles d'e-mail dans Dolibarr : les variables (__REF__…), le bon destinataire et le PDF joint
Écrire un modèle d'e-mail de facture dans Dolibarr : les variables qui marchent (__REF__, montant, échéance, contact), les pièges du tiret bas et du PDF qui ne part plus, et comment faire partir l'e-mail au bon contact. Testé sur Dolibarr 24.0.2 et 23.0.4.
· Dolibarr 24.0.2 et 23.0.4 (testés le 03/11/2026)Les acomptes dans Dolibarr : marge, déduction, trop-perçu et répartition sur plusieurs factures
Créer une facture d'acompte depuis une commande, la déduire de la facture finale, gérer un client qui a trop payé, répartir un acompte sur plusieurs factures. Ce que devient la marge dans chaque cas. Testé sur Dolibarr 24.0.2 et 23.0.4.
· Dolibarr 16 à 24.0.2Diagnostiquer une erreur Dolibarr : collez le message, l'outil trouve la cause et le guide
Collez un message d'erreur de Dolibarr, de PHP ou du serveur d'e-mails : l'outil reconnaît 39 messages, relevés dans le code de Dolibarr 16 à 24 ou cités par nos guides, donne la cause la plus probable et renvoie vers la solution.
· Dolibarr 24.0.2 (archive officielle) · Debian 13 et Ubuntu 24.04 LTS · Nginx et PHP-FPM des paquets de la distributionInstaller Dolibarr avec Nginx : la configuration testée, et les trois pièges de l'exemple officiel
Installer Dolibarr 24 avec Nginx, PHP-FPM et MariaDB sur Ubuntu ou Debian, configuration testée. Et ce que l'exemple fourni avec Dolibarr ne fait pas : API REST en 404, envois bloqués à 1 Mo, dossiers protégés seulement sous Apache.
· Dolibarr 24.0.2, publiée le 2 octobre 2026 · état de la branche 24.0 relevé le 30 octobre 2026Dolibarr 24.0.2 : ce qui change, et faut-il mettre à jour ?
La 24.0.2 est une version de corrections : 260 correctifs, dont 28 qui touchent la sécurité et les droits d'accès. Ce qui change au quotidien, qui doit mettre à jour, et ce qui attend déjà la prochaine 24.0.x.
· Dolibarr 24.0.2 (image Docker officielle) · plan comptable PCG25-DEV · article A47 A-1 du Livre des procédures fiscales lu le 22/10/2026Comptabilité dans Dolibarr : configurer la partie double, transférer les factures et exporter le FEC
La comptabilité en partie double de Dolibarr 24 testée de bout en bout : le bon plan comptable, les comptes par défaut, l'exercice fiscal, la liaison des factures, les journaux, puis l'export FEC contrôlé face à l'article A47 A-1, avec les trois pièges qui bloquent au démarrage.
· Dolibarr 24.0.2 (testé le 22/10/2026)Dolibarr comme CRM : prospects, relances, opportunités et formulaire de contact
Utiliser Dolibarr 24 comme CRM, testé de bout en bout : qualifier les prospects, programmer les relances avec rappel, suivre les opportunités dans un pipeline, passer du devis signé au client, recevoir des demandes par un formulaire public. Avec les réglages à faire et ce que Dolibarr ne fait pas seul.
· Dolibarr 24.0.2 (testé le 22/10/2026)Doublons dans Dolibarr : les empêcher, les retrouver et fusionner les tiers, contacts et adhérents
Dolibarr 24 accepte deux clients ou deux contacts identiques sans prévenir. Les règles d'unicité à activer (e-mail, SIREN, TVA) et leurs limites, comment retrouver les doublons, et la fusion native des tiers et des adhérents, testée. Les contacts, eux, ne se fusionnent pas.
· Dolibarr 24.0.2 (dernière version stable le 22/10/2026) · prix et offres relevés le 22/10/2026 · catalogue DoliStore du 13/10/2026Dolibarr est-il gratuit ? Ce qui est gratuit, ce qui coûte, et l'utiliser en ligne
Dolibarr est un logiciel libre, gratuit sans limite d'utilisateurs. Ce qui peut coûter : l'hébergement, des modules du DoliStore, de l'aide. Les essais gratuits en ligne, le prix de l'offre hébergée DoliCloud et les chiffres réels du DoliStore, vérifiés en octobre 2026.
· Dolibarr 24.0.2 et Odoo 20.0 Community (images Docker officielles du 15 et du 21/10/2026) · prix relevés le 22/10/2026Dolibarr ou Odoo ? Les deux installés et comparés sur le même cas
Dolibarr 24 et Odoo 20 installés côte à côte et testés sur le même cas, du devis au paiement : ce qui est vraiment gratuit, le coût réel pour 3 utilisateurs, la facture électronique, le stock, ce que chacun fait mieux, et comment passer d'Odoo à Dolibarr.
· Dolibarr 24.0.2 (image Docker officielle) · mêmes réglages sur les versions récentes, libellés parfois différentsThème Dolibarr : changer les couleurs, le logo et l'apparence sans module
Changer le thème de Dolibarr pas à pas sur la version 24 : thèmes Eldy et MD, vos couleurs, le logo dans le menu (et le piège du logo carré), le mode sombre, la page de connexion, le CSS personnalisé, le thème de chaque utilisateur et la caisse TakePOS.
· Dolibarr 24.0.2 (image Docker officielle, PHP 8.2, MariaDB 11.4) · module EInvoicing 1.3.0 · état de la réglementation au 20/10/2026Dolibarr et la facture électronique : ce que dit la loi, ce que fait Dolibarr 24 et le module EInvoicing, testé
Réception obligatoire depuis le 1er septembre 2026, émission en 2027 pour les PME et micro-entreprises : ce que Dolibarr 24 fait seul, le module officiel EInvoicing installé et testé, les erreurs qui bloquent et les réglages du PDF.
· Dolibarr 22.0.5, 23.0.4 et 24.0.1 mis à jour vers 24.0.2 (archives officielles .tgz) · Debian 13, PHP 8.4, MariaDB 11.8Mettre à jour Dolibarr en ligne de commande : les commandes, les pièges et un script testé
Mettre à jour Dolibarr sans l'assistant web : upgrade.php, upgrade2.php et step5.php, une étape par version, le piège d'upgrade.unlock qui bloque la 2e étape sans erreur, et un script complet avec sauvegarde et retour arrière, testé de la 22 à la 24.
· Dolibarr 24.0.2 (archive officielle, installée par l'assistant web ; PHP 8.2) · même contrôle dans les versions plus anciennes, texte parfois sans parenthèse« Dolibarr config file content seems to be not correctly defined » : trouver la cause et réparer sans tout réinstaller
Le message « Dolibarr config file content seems to be not correctly defined » reproduit cause par cause sur Dolibarr 24 : ce que dit la parenthèse, le déménagement de serveur, le fichier disparu, les tâches planifiées, et pourquoi relancer /install sur une instance existante n'est pas anodin.
· Dolibarr 24.0.2 (archive officielle, installée par l'assistant web ; PHP 8.2)Dolibarr n'envoie pas les e-mails : configurer le SMTP et comprendre chaque message d'erreur
L'envoi d'e-mails de Dolibarr 24 testé sur trois serveurs SMTP : les bons réglages pour les ports 587 et 465, la signification de chaque message d'erreur, le mot de passe qui ne marche plus après une migration, et les réglages qui détournent les e-mails sans le dire.
· Dolibarr 24.0.2 (archive officielle, installée par l'assistant web ; PHP 8.2, MariaDB 11.4)Champs calculés dans Dolibarr : créer une formule, des exemples qui marchent, et ce qui s'affiche dans les listes, les PDF et la base
Les champs calculés de Dolibarr 24 testés sur une installation neuve : où créer la formule, des exemples qui fonctionnent (prix TTC, cartons par ligne, enseigne du tiers), pourquoi la liste affiche parfois une autre valeur, l'option cachée qui enregistre le résultat en base et son piège.
· Dolibarr 24.0.2 (archive officielle, installée par l'assistant web ; PHP 8.2, MariaDB 11.4)Sécuriser une instance Dolibarr hébergée : install.lock, restriction d'IP, 2FA, intégrité des fichiers et suivi des failles
Les réglages de sécurité de Dolibarr 24 testés un par un sur une installation neuve : install.lock, conf.php, restriction par adresse IP et plages CIDR, double authentification, captcha, vérification d'intégrité, DoliSecure, version affichée.
· Dolibarr 24.0.2 (testé : image Docker officielle 24.0.1 dont le code a été remplacé par celui de la 24.0.2, absente de Docker Hub au 14/10/2026 ; MariaDB 11.4)Importer des données dans Dolibarr depuis un fichier CSV ou Excel : l'assistant pas à pas, les mises à jour et les erreurs fréquentes
L'assistant d'import de Dolibarr 24 testé avec de vrais fichiers CSV et Excel : tiers, contacts, produits, stocks, prix d'achat, catégories, mise à jour par clé, et les messages exacts des erreurs les plus fréquentes.
· Dolibarr 24.0.2 (testé : image Docker officielle 24.0.1 dont le code a été remplacé par celui de la 24.0.2, absente de Docker Hub au 14/10/2026 ; MariaDB 11.4)Stock physique, stock virtuel et inventaire dans Dolibarr : ce qui fait bouger le stock, et pourquoi le stock virtuel paraît faux
Ce qui fait bouger le stock physique et le stock virtuel de Dolibarr 24, six raisons testées pour lesquelles le stock virtuel paraît faux, et l'inventaire intégré pas à pas, avec le bug du bouton de clôture en 24.0.2.
· Dolibarr 24.0.2 (testé : image Docker officielle 24.0.1 dont le code a été remplacé par celui de la 24.0.2, absente de Docker Hub au 14/10/2026 ; MariaDB 11.4, PHP 8.2)Imprimer les tickets de caisse avec TakePOS (Dolibarr 24) : navigateur, imprimante ESC/POS, modèle de ticket et tiroir-caisse
Les trois façons d'imprimer un ticket avec TakePOS dans Dolibarr 24, testées avec une imprimante ESC/POS simulée : réglages, modèle de ticket et balises, impression automatique, tiroir-caisse, et les pannes qui laissent le ticket vide ou coupé.
· Dolibarr 24.0.1 (testé) ; le défaut d'ordre des lignes est aussi dans le code de la 24.0.2 et de la branche de développement au 13/10/2026API REST de Dolibarr : créer la clé API, puis une facture complète avec curl (testé en 24)
Activer l'API REST de Dolibarr, créer une clé API pour un utilisateur dédié, puis créer un client, une facture, son PDF et son paiement avec curl. Avec le piège des lignes qui changent d'ordre.
· Dolibarr 24.0.1 (testé) ; la liste des modèles a changé en 24.0 (crabe supprimé), la mention de TVA concerne les versions 21 à 24Personnaliser la facture PDF de Dolibarr 24 : les réglages sans code, le modèle ODT et un modèle sur mesure qui survit aux mises à jour
Logo, mentions légales, TVA non applicable, pénalités de retard, IBAN, filigrane, modèle ODT et conversion en PDF, modèle PHP dans custom : chaque étape testée sur Dolibarr 24.0.1, avec les pièges.
· Dolibarr 24.0.1 (testé, image Docker officielle, MariaDB 11.4) ; le principe vaut pour toutes les versions récentesSauvegarder et restaurer Dolibarr, ou le déplacer sur un autre serveur : la méthode testée, et la clé que tout le monde oublie
Les quatre éléments à sauvegarder, la sauvegarde automatique intégrée à Dolibarr, et une restauration testée sur une instance neuve. Sans la clé de conf.php, les IBAN clients et les clés API restent illisibles.
· Image officielle dolibarr/dolibarr 24.0.1 (dernière image publiée au 13/10/2026), MariaDB 11.4 ; les trois pièges viennent du script de démarrage commun à toutes les versions de l'imageInstaller Dolibarr avec Docker Compose (image officielle) : la configuration testée, et les trois pièges de l'exemple officiel
Un docker-compose.yml complet pour Dolibarr 24 et MariaDB, testé de bout en bout. Avec l'exemple officiel, les mots de passe sont stockés en MD5 avec une copie en clair, et les tâches planifiées ne tournent jamais : comment l'éviter.
· Dolibarr 24.0.2 (archive officielle) · Ubuntu 24.04 LTS (PHP 8.3, MariaDB 10.11, Apache 2.4.58) · Debian 13 (PHP 8.4, MariaDB 11.8, Apache 2.4.68)Installer Dolibarr sur Ubuntu ou Debian : les commandes testées, et les quatre réglages que l'assistant oublie
Installer Dolibarr 24 sur Ubuntu 24.04 ou Debian 13 avec Apache, MariaDB et PHP, commandes testées. Plus ce que l'assistant ne fait pas : install.lock, limite d'envoi de 2 Mo, dossier des documents, clé du cron.
· Même logique dans le programme d'installation des versions 19, 22 et 24 · testé sur 24.0.1install.lock dans Dolibarr : où le mettre, et comment faire une mise à jour avec
Le fichier install.lock ferme les pages d'installation de Dolibarr. Le bon dossier, le piège de htdocs, et upgrade.unlock pour faire une mise à jour sans le supprimer.
· Même contrôle dans le programme d'installation des versions 19, 22 et 24 · testé sur 24.0.1 (Apache, PHP 8.2)« Installation non autorisée par les permissions du fichier conf.php » : débloquer l'installation de Dolibarr
L'assistant d'installation de Dolibarr refuse de démarrer à cause du fichier conf.php. Ce que veut dire le message, la commande qui le règle, et le piège du chmod 666.
· Méthode par la base acceptée par le code de connexion des versions 17, 19, 22 et 24 · testée sur 24.0.1 (MariaDB)Mot de passe administrateur Dolibarr perdu : les trois façons de le réinitialiser
Plus personne ne connaît le mot de passe de l'administrateur Dolibarr. Le lien « Mot de passe oublié », un autre administrateur, ou la base de données, sans casser le hachage.
· Contrôle présent dans le programme d'installation des versions 19, 22 et 24 · testé sur 24.0.1 (Apache, PHP 8.2)« Votre installation PHP ne prend pas en charge les fonctions Intl » : ce que ça bloque dans Dolibarr, et comment l'activer
L'installation de Dolibarr signale que PHP ne prend pas en charge Intl. Ce n'est qu'un avertissement : ce qui en dépend vraiment, et comment activer l'extension selon votre serveur.
· Dolibarr 24.0.0 à 24.0.2 et branche de développement · champ toujours affiché jusqu'en 23 · testé de 23.0.4 vers 24.0.1Dolibarr 24 : le champ civilité a disparu des contacts
Après le passage en version 24, la civilité (M., Mme, Dr…) n'apparaît plus sur les fiches contact. C'est voulu, et une constante la fait revenir.
· Dolibarr 24.0.0 et 24.0.1, avec la recherche des tiers par saisie · 23 non touchée · corrigé dans le code de la 24.0.2 (pas encore annoncée au 4 octobre 2026)Dolibarr 24.0.0 et 24.0.1 : en ajoutant un contact, la liste des tiers n'affiche que des traits
Dans l'onglet Contacts d'un devis, d'une commande ou d'un projet, la recherche du tiers ne propose que des lignes vides. Un bug des 24.0.0 et 24.0.1 quand la recherche des tiers par saisie est activée.
· Dolibarr 23 et 24 · pas de liste blanche en 22 · testé en 22.0.5, 23.0.4 et 24.0.1Champ calculé refusé depuis Dolibarr 23 : la liste blanche $dolibarr_main_restrict_eval_methods
Depuis la version 23, un champ calculé ne peut plus appeler n'importe quelle fonction, ni faire d'include, ni concaténer avec un point. Les règles exactes, les messages, et la façon propre d'appeler le code d'un module.
· Dolibarr 20 à 24.0.2 · testé en 20.0.4 et 24.0.1 · corrigé seulement dans la branche de développement (25.0.0-alpha)Dolibarr : la méthode d'expédition n'apparaît pas sur le bon d'expédition (modèle Espadon)
Vous avez choisi une méthode d'expédition, mais le PDF Espadon ne l'affiche pas. Elle n'est imprimée que s'il y a un numéro de suivi. Deux façons de l'obtenir.
· Passage d'une version 21 ou plus ancienne vers la 22, la 23 ou la 24 · testé de 21.0.4 vers 24.0.1Mise à jour de Dolibarr bloquée : « commonsubtotal.class.php: Failed to open stream »
Pendant une mise à jour vers la 22, la 23 ou la 24, l'assistant s'arrête sur un fichier subtotals introuvable. Ce n'est pas un module externe : la copie des fichiers est incomplète.
· Dolibarr 20 à 24 · testé en 20.0.4 et 24.0.1 · même code en 24.0.2 et dans la branche de développementDolibarr : dans une nomenclature, le coût d'un service affiche 3 600 fois trop
Un service de 10 minutes sur un poste à 30 €/h devrait coûter 5 €, et la ligne de la nomenclature affiche 18 000 €. Une cause reproduite : le libellé court de l'heure dans le dictionnaire des unités.
· Dolibarr 20 à 24.0.1 · reproduit en 23.0.4 et 24.0.1 · corrigé dans le code de la 24.0.2 (pas encore annoncée au 4 octobre 2026)Dolibarr : la description du produit n'est plus traduite sur le PDF après modification d'une ligne
Un devis pour un client anglophone sort en anglais, puis repasse en français dès qu'on modifie une ligne. La cause : l'éditeur enrichi et une description sur plusieurs lignes. Trois façons d'en sortir.
· Dolibarr 20 à 24 · testé en 20.0.4 et 24.0.1 (vendeur et client en France)Dolibarr : la TVA d'un prix par client n'est pas reprise sur la ligne du devis
Vous avez saisi un prix client avec une TVA à 10 %, et la ligne du devis sort à 20 %. D'où vient le taux de TVA proposé sur une ligne, et comment obtenir le bon.
· Dolibarr 16 à 24 · constats vérifiés sur 24.0.0Erreur 500 ou page blanche dans Dolibarr : trouver la cause en quelques minutes
Une erreur 500 dans Dolibarr n'affiche rien, et le journal de Dolibarr ne la contient pas. Où lire le vrai message, comment le comprendre, et les quatre causes qui reviennent presque toujours.
· Dolibarr 16 à 24 · dernière version au 26/10/2026 : 24.0.2 (publiée le 2/10/2026, annoncée sur dolibarr.org)Mettre à jour Dolibarr sans rien casser : la méthode, et ce qui change de la version 16 à la 24
Ce qui casse vraiment lors d'une mise à jour de Dolibarr, la liste de contrôle avant de commencer, la procédure, le retour arrière, et le tableau des versions 16 à 24 : PHP, modules retirés, pièges.
· Image officielle dolibarr/dolibarr, versions 16 à 24, avec MariaDB ou MySQL · dernière image au 26/10/2026 : 24.0.2 (PHP 8.5)Mettre à jour Dolibarr sous Docker (image officielle) : pourquoi il ne faut jamais sauter de version
Avec l'image Docker officielle, passer de la 20 à la 24 d'un coup laisse une base incomplète, sans aucune erreur. Ce qui se passe, comment le vérifier chez vous, et la bonne procédure, testée.
· Dolibarr 24.0.0 · corrigé en 24.0.1« Accès refusé » à la création d'un compte bancaire en Dolibarr 24.0.0
En Dolibarr 24.0.0, la création d'un compte bancaire est refusée selon la référence saisie, même en administrateur. Cause réelle, et correctif en 24.0.1.
· Dolibarr 23.0.0 à 24.0.1 · colonne présente en 22 · rétablie dans la 24.0.2, publiée le 2/10 sur SourceForge mais pas encore annoncée sur dolibarr.org au 4 octobre 2026Dolibarr 23 : le champ « Privé » des modèles de courriel a disparu de l'écran
Depuis Dolibarr 23, la colonne « Privé » a disparu de l'administration des modèles d'e-mails. Le champ existe toujours et filtre. Cause et contournement.
· Dolibarr 24 · comportement différent en 23.0.4Dolibarr 24 : le cadre « Émetteur » se dessine par-dessus le logo des PDF
En Dolibarr 24, sur les modèles Eratosthène et Proforma, le cadre de l'émetteur remonte sur le logo quand la position d'adresse La Poste est activée.
· Dolibarr 23.0.4 et 24Suivre la marge par journée de chantier avec Dolibarr seul
Module Projets, taux horaire moyen et temps consommé suffisent à savoir ce qu'une journée de chantier a rapporté. Méthode rejouée en 23.0.4 et 24.
· Dolibarr 23Dolibarr refuse de créer un projet sans statut d'opportunité
Dolibarr exige un statut d'opportunité à la création d'un projet parce qu'une case est cochée par défaut. Il suffit de la décocher. Vérifié en 23.
· Dolibarr 24.0.x · correctif présent dans la branche de développementDolibarr 24 : la référence fournisseur saisie sur une commande n'est pas enregistrée
En Dolibarr 24.0.x, la référence saisie sur une commande fournisseur se perd si le produit n'a pas de prix d'achat chez lui. Deux contournements.
· Dolibarr 24 pour la vérification · renommage intervenu en version 12Retenues de garantie dans Dolibarr : les constantes que vous cherchez n'existent plus
Les constantes citées sur le web pour la retenue de garantie ont été renommées en version 12. Le réglage est aujourd'hui dans les factures de situation.
· Dolibarr 23.0.3 · code identique en 23.0.4 sur ce point« Token not provided » après une double authentification : de quel jeton s'agit-il
Le message ne parle pas de votre code à six chiffres mais du jeton anti-CSRF de Dolibarr. Ce que dit le code de la 23.0.3, et par où prendre le diagnostic.
Une de ces notes décrit un besoin que l’un des modules couvre ? Le renvoi est écrit dans la note elle-même, jamais ajouté après coup.