Comment installer un module Dolibarr ?

Envoyer le fichier du module depuis Dolibarr, l'activer, puis le mettre à jour quand une nouvelle version sort.

Dolibarr · installer un module
01 / 08
Procédure pas à pas

Installer
un module
dans
Dolibarr.

Envoyer le fichier du module depuis Dolibarr, l’activer, puis le mettre à jour quand une nouvelle version sort.

ÉditionOctobre 2026
AudienceAdministrateurs Dolibarr
VersionsDolibarr 18 à 24
02 / 08
Le parcours

Envoyer, puis activer.

Un module externe (DoliStore, ATM…) arrive sous la forme d’un fichier .zip. Dolibarr sait l’installer lui-même, à condition que le serveur le permette.

  1. Avant de commencer : le fichier et le serveur1 min
  2. Envoyer le fichier du module~2 min
  3. Activer le module1 min
  4. Mettre à jour un module~2 min
  5. En cas de problème4 cas
03 / 08
Avant de commencer

Le fichier, et ce que le serveur doit permettre.

Il faut…
Détail
Sinon
Le fichier du module
Un .zip nommé comme module_nom-1.2.3.zip : le nom, un tiret, puis le numéro de version. Ne le renommez pas.
Dolibarr refuse le fichier
Un accès administrateur
La configuration des modules est réservée aux administrateurs.
Le menu Configuration n’apparaît pas
Un serveur qui l’autorise
Le dossier des modules externes (custom) déclaré dans la configuration du serveur, et Dolibarr autorisé à y écrire.
Un message l’indique dans l’onglet d’installation ; voir « En cas de problème »
Versions

Vérifiez la compatibilité avant d’installer

Chaque module indique les versions de Dolibarr (et de PHP) qu’il demande. Installer un module trop ancien ou trop récent peut empêcher son activation.

Captures faites sur Dolibarr 24. Les écrans sont les mêmes depuis la version 18.

Installer 04 / 08
Étapes 1 et 2

Ouvrir l’installation, puis envoyer le fichier.

  1. Accueil → Configuration
    Ouvrir Modules / Applications

    Cliquez sur Accueil, puis sur Modules / Applications dans la partie Configuration du menu de gauche.

    Menu de gauche, lien Modules / Applications sous Configuration entouré en rouge
    Fig. 02 — Configuration, puis Modules / Applications
  2. Onglet Déployer/Installer un module externe
    Envoyer le fichier .zip

    Cliquez sur l’onglet Déployer/Installer un module externe.

    Onglets de la page des modules, onglet Déployer/Installer un module externe entouré en rouge
    Fig. 03 — Onglet d’installation

    Choisissez le fichier .zip avec le bouton de sélection de fichier (son libellé dépend de votre navigateur : « Parcourir », « Choisir un fichier »…), puis cliquez sur Envoyer fichier.

    Sélection du fichier et bouton Envoyer fichier, entourés en rouge
    Fig. 04 — Envoi du fichier

    Un message confirme que l’installation est terminée et rappelle qu’il reste à activer le module.

Installer 05 / 08
Étape 3

Activer le module.

  1. Onglet Modules / applications disponibles
    Le retrouver, puis l’activer

    Revenez au premier onglet, tapez le nom du module dans le filtre, puis cliquez sur son interrupteur : il passe au vert. Un module externe affiche son numéro de version sous son icône, ce qui le distingue d’un module de Dolibarr au nom proche.

    Filtre réglé sur sous-total, et interrupteur du module externe Sous-total en version 3.30.3, entourés en rouge
    Fig. 05 — Filtre et interrupteur d’activation

    Si le module a des réglages, une roue dentée apparaît sur sa vignette : elle ouvre sa configuration.

Activez, puis vérifiez les droits. À l’activation, Dolibarr ne donne que les droits que le module prévoit par défaut : vérifiez ceux des utilisateurs ou des groupes qui doivent s’en servir.

06 / 08
Mise à jour

Mettre à jour un module.

La même procédure, avec un geste de plus pour que le module mette sa base de données à jour.

  1. Onglet Déployer/Installer un module externe
    Envoyer le fichier de la nouvelle version

    Envoyez le .zip de la nouvelle version comme pour une installation : ses fichiers remplacent ceux de l’ancienne.

  2. Onglet Modules / applications disponibles
    Désactiver, puis réactiver le module

    Cliquez deux fois sur son interrupteur : à la réactivation, le module applique ses mises à jour de base de données. Ses données sont conservées.

07 / 08
Avant d’ouvrir un ticket

En cas de problème.

ÉCRITURE
« Impossible d’écrire dans le répertoire … custom »

Pourquoi : le serveur n’autorise pas Dolibarr à écrire dans le dossier des modules externes.

Que faire : demander à l’administrateur du serveur de l’autoriser, ou de copier lui-même le contenu du .zip dans ce dossier.

VERROUILLÉ
« L’installation de modules externes à partir de l’application … ont été désactivées par votre administrateur »

Pourquoi : l’administrateur du serveur a verrouillé l’installation depuis Dolibarr, par sécurité.

Que faire : lui demander d’installer le module.

NOM DU FICHIER
« Le nom de fichier du package du module … ne correspond pas à la syntaxe de nom attendue »

Pourquoi : le fichier a été renommé, et le numéro de version a disparu de son nom.

Que faire : lui redonner son nom d’origine, du type module_nom-1.2.3.zip.

ACTIVATION
Le module refuse de s’activer, ou un message signale un module manquant

Pourquoi : il demande une autre version de Dolibarr ou de PHP, ou il dépend d’un autre module absent.

Que faire : lire le message : installer d’abord le module demandé, ou obtenir une version compatible.

08 / 08
Fin du document

Envoyer,
activer,
donner les droits.

Le fichier .zip s’envoie depuis Dolibarr, le module s’active d’un clic. Pour une mise à jour : envoyer la nouvelle version, puis désactiver et réactiver le module.

Captures : Dolibarr 24.0.2, module Sous-total d’ATM
Écrans identiques de la version 18 à la 24
Dernière revue : octobre 2026