Installation - Mise à jour

Retour index
Documentation Utilisateur

Les procédures suivantes décrivent comment installer ou mettre à jour Dolibarr.

Installer Dolibarr - Procédure d'installation

Ce chapitre décrit les différentes méthodes possibles (des plus simples, aux manuelles) pour une première installation. Voir plus loin pour la mises à jour.

Sur votre poste/serveur dédié

Avec DoliWamp (pour Windows)

- Prérequis: Windows

- Niveau: Débutant

Attention, ce mode d'installation n'est pas disponible pour toutes les versions de Dolibarr. Seules quelques versions bénéficie de cet installateur clé en main.

Si vous maîtrisez l'installation d'un serveur Web Apache, de PHP et MySQL, la section Avec Dolibarr (package standard .zip ou sources Git) est plus appropriée et disponible pour toute version.

Si vous avez du temps et que vous souhaitez apprendre à installer un serveur Web Apache, PHP et MariaDB, consultez la page Installation manuelle sous Windows pour des instructions pas à pas.

Pour les moins expérimentés qui sont sous Windows, il existe une distribution Dolibarr nommée DoliWamp qui permet de faire une installation Dolibarr sous Windows avec tous ses prérequis (Apache, Mysql, PHP) sans connaissance informatiques. Voici comment l'installer:

• Récupérez la version de Dolibarr pour Windows.

Pour cela, voir le site Sourceforge mirror

• Lancer le .exe téléchargé et suivez les instructions.

Avec DoliDeb (package Debian / Ubuntu .deb)

- Prerequis: Linux Debian, Ubuntu, ...

- Niveau : Débutant

Cette procédure fonctionne uniquement pour les utilisateurs Linux Debian, Ubuntu et dérivés et est recommandée pour ceux qui n'ont pas de connaissances informatiques particulières. Si vous êtes un administrateur expérimenté d'Apache, PHP et Mysql, le chapitre Avec Dolibarr (package standard zip) sera peut-être plus approprié. Dans le cas contraire, vous pouvez utilisez DoliDeb. DoliDeb est un package de Dolibarr spécialisé pour la distribution Debian ou Ubuntu. Ce package vous permet d'installer Dolibarr sous Ubuntu ou Debian (ou dérivé) avec tous ces prérequis (Apache, Mysql, PHP) s'ils ne sont pas déjà installés et ce sans connaissances techniques particulières.

• La procédure pour installer DoliDeb est décrite sur la page Dolibarr pour Ubuntu ou Debian.

Avec DoliRpm (package Fedora, Redhat, Mandriva, Mageia ou OpenSuse .rpm)

- Prerequis : Linux Fedora, Redhat, Mandriva, Mageia or OpenSuse (peut également fonctioner pour toute distribution Linux à rpm)

- Niveau : Débutant

Cette procédure fonctionne uniquement pour les utilisateurs Linux d'une distribution gérant les packages rpm et est recommandée pour ceux qui n'ont pas de connaissances informatiques particulières. Si vous êtes un administrateur expérimenté d'Apache, PHP et Mysql, le chapitre suivant Avec Dolibarr (package standard zip) sera peut-être plus approprié. Dans le cas contraire, vous pouvez utilisez DoliRpm. DoliRpm est un package de Dolibarr spécialisé pour la distribution Fedora, Redhat, Mandriva, Mageia ou OpenSuse. Ce package vous permet d'installer Dolibarr sous ces OS avec tous ces prérequis (Apache, Mysql, PHP) s'ils ne sont pas déjà installés et ce sans connaissances techniques particulières.

• La procédure pour installer DoliRpm est décrite sur la page Dolibarr pour Redhat ou Fedora (package rpm) ou Dolibarr pour Mandriva ou Mageia (package rpm) ou Dolibarr pour OpenSuse (package rpm).

Avec Dolibarr (package standard .zip ou sources Git pour Windows, Mac OS, OS X, Linux, BSD, ...)

- Prérequis : Apache, PHP et un serveur de base de données (MySQL ou PostgreSQL) sont présents et opérationnels, et le login/mot de passe d'accès (au serveur de base de donné, ou à l'utilisateur root système) est connu.

- Niveau : Un peu de connaissances informatiques en administration Web.

Cette procédure décrit l'installation manuelle (recommandée) sur un système GNU/Linux (Debian, Mandriva, ...) mais elle est valable avec d'autres systèmes moyennant une adaptation des chemins à ceux de votre OS.

Elle est applicable pour toute version de Dolibarr >= 2.0.0

Pour des instructions spécifiques à une installation sous Windows, vous pouvez consulter la page Installation manuelle sous Windows.

• Vérifiez que vous avez bien Apache, PHP 7.1.0+ et un serveur de base de données (MySQL 5.7.7+, MariaDB ou PostgreSQL) d'installés (consulter pour cela la liste des packages installés sur votre machine grâce au gestionnaire de mise à jour de package de votre distribution).
• Vérifiez que le serveur Web est lancé (systemctl status apache2 ou systemctl status httpd.service par exemple). L'activer le cas échéant (systemctl enable --now apache2 ou systemctl enable --now httpd.service)

• Vérifiez que le compte utilisateur root ou admin du serveur de base de donnée est connu et fonctionne correctement. Si cet utilisateur root ou admin est inconnu (car pas encore défini par exemple), lisez le chapitre qui suit (Sinon vous pouvez passez au point d'après):

Installation du serveur de base de donnée

MySql ou MariaDB

Installer le serveur de base de donnée (Voir la doc de votre serveur). Vérifiez que le serveur de base de données est lancé (systemctl status mysqld.service par exemple). L'activer le cas échéant (systemctl enable --now mysqld.service).

Pour les utilisateurs Linux utilisant MySql ou MariaDB, si vous venez juste d'installer la base de donnée, le login administrateur est root. Vous devez exécuter la commande suivante pour initialiser le mot de passe:

mysql

Une fois dans l'interface Mysql, taper la commande de modification du mot de passe de root:

grant all privileges on *.* to root@'localhost' identified by 'newrootpass' with grant option;

(A partir de MySQL 8 il faut d'abord créer le USER) Puis entrée et pour quitter \q

Pour vérifier que l'accès avec ce couple user/mot de passe fonctionne, lancer la commande

mysql -u root -p

Et taper votre mot de passe newrootpass suivi de \q pour quitter la sessions si la connexion a réussie.

Postgresql

Pour les utilisateurs Linux utilisant Postgresql, si vous venez juste d'installer la base de donnée PostgreSQL, vous devez d'abord créer un utilisateur administrateur et son mot de passe. Pour cela, ajouter la ligne suivante dans le fichier /etc/postgresql/x.x/main/pg_hba.conf (remplacer x.x avec votre version de postgres)

local   all         dolibarrowner    md5

De plus, mettez en commentaire la ligne

#local   all         all                               ident

qui impose que le compte système utilisé pour accéder à la base (ce sera le compte sous lequel tourne l'application web), ait le même nom que le compte dans la base (ce n'est jamais le cas).

Ensuite, lancer la commande sous un shell root

sudo -s -u postgres
createuser dolibarrowner
psql -d template1 -c "alter user dolibarrowner with password 'dolibarrownerpass'"
exit
psql
create database databasename;
grant all privileges on database databasename to dolibarrowner;
ALTER DATABASE databasename OWNER TO dolibarrowner;
\q
sudo /etc/init.d/postgresql restart

Vous pouvez tester la connexion pour l'utilisateur crée avec la commande

psql -h localhost -d postgres -U dolibarrowner -W

Et entrez le mot de passe dolibarrownerpass et \q pour quitter la session si la connexion est ok.

Copie des fichiers

• Placez-vous dans le répertoire dans lequel installer Dolibarr (le répertoire racine défini pour votre serveur web)

1. Pour Debian et les familles Ubuntu, il s'agit en général de: /var/www
2. Pour Mandriva, Mageia, RedHat, Fedora: /var/www/html
3. Pour Suse: /srv/www/htdocs

$ cd /var/www

• Récupérez l'application

Avec l'archive

Si vous partez du fichier dolibarr.zip, récupérez le fichier et décompressez l'archive de l'application (ex: version 12.0.4)

$ wget 'https://sourceforge.net/projects/dolibarr/files/Dolibarr ERP-CRM/12.0.4/dolibarr-12.0.4.zip'
$ unzip dolibarr.zip

Renommez le répertoire dolibarr-x.y.z en dolibarr afin d'avoir un nom de répertoire indépendant de la version (où x.y.z correspond à la version source)

$ mv dolibarr-x.y.z dolibarr

Avec les sources Git

Si vous partez des sources Git, récupérer les sources par

$ git clone -b X.Y http://github.com/Dolibarr/dolibarr.git dolibarr

X.Y est la version majeure à installer(Par exemple 9.0, 11.0, ...). Il est possible de remplacer X.Y par develop pour récupérer la version en cours de développement.

Gestion des droits

Modifiez les permissions et propriétaires du répertoire 'dolibarr' pour être sur que tous les fichiers soient en lecture pour l'utilisateur sur lequel tourne le serveur (on supposera qu'il s'agit de l'utilisateur 'www-data' pour debian ou ubuntu, 'apache' pour Redhat, Mandriva, Mageia, Fedora)

$ chmod -R 755 /var/www/dolibarr
$ chown -R www-data:www-data /var/www/dolibarr
ou
$ chmod -R 755 /var/www/html/dolibarr
$ chown -R apache:apache /var/www/html/dolibarr

Fichier de configuration

En tant que root, créez, dans le répertoire dolibarr/htdocs/conf, un fichier de configuration vide, et attribuez-lui comme propriétaire du fichier, l'utilisateur du serveur web (exemple www-data sur debian, nobody sur une vieille RedHat, apache sur une autre version ...). Ceci est requis car le serveur web a besoin d'écrire dans ce fichier lors de l'installation.

$ cd dolibarr ; touch htdocs/conf/conf.php ; chown www-data htdocs/conf/conf.php

SELinux sur Fedora

Sur Fedora, comme SELinux est activé en général, il est aussi conseillé de lancer les commandes pour rendre le répertoire 'dolibarr' accepté par l'environnement SELinux (an absence de commande, vous devriez recevoir des nombreuses alertes d'anomalies) :

$ semanage fcontext -a -t httpd_sys_rw_content_t '/var/www/html/dolibarr(/.*)?'
$ restorecon -R -v '/var/www/html/dolibarr'

Afin de pouvoir utiliser la sauvegarde sqldump et d'autres fonctions sur dolibarr dans un contexte SELinux vous devez ajouter 2 commandes :

$ sudo setsebool -P httpd_can_network_connect_db 1

Ce qui donne l’autorisation au serveur web de se connecter à la base (par exemple mariadb ou mysql)

$ sudo setsebool -P httpd_can_network_connect 1

Ce qui permet les connexions notamment sur le serveur local (localhost).

Répertoire de documents

Toujours en root, créez le répertoire qui servira aux documents générés ou stockés par Dolibarr (factures pdf, images, ...), et attribuez lui comme propriétaire, l'utilisateur du serveur web (exemple www-data sur Debian, nobody sur une vieille RedHat, apache sur une Mandriva, Mageia ou une RedHat récente, ...). Le serveur web doit avoir les droits en écriture dans ce répertoire. Il faut choisir un répertoire en dehors de la racine du site web. Par exemple "/var/lib/dolibarr/documents"

$ mkdir -p /var/lib/dolibarr/documents ; chown www-data /var/lib/dolibarr/documents

Installation

• Pointez votre navigateur sur la page principale

http://127.0.0.1/dolibarr/htdocs/

• Suivez les instructions de l'installation

• Pour des raisons de sécurité, il est nécessaire, une fois l'installation terminée, de créer un fichier install.lock dans le répertoire dédiés aux documents, que seul root doit avoir le droit d'effacer. Ceci va verrouiller la procédure d'installation qui ne pourra plus être appelée par erreur (Il faudra le supprimer, ou créer un fichier upgrade.unlock au moment des mises à jour).

$ touch /var/lib/dolibarr/documents/install.lock; chmod go-w /var/lib/dolibarr/documents;

Sur un hébergement mutualisé (à accès restreint)

Certains hébergeurs proposaient une installation "en un clic" (OVH par exemple) : ils ont pour la plus part abandonné car trop questionnés pour des questions d'utilisation/administration : ils vous renverront maintenant vers ce wiki ou vers le forum dolibarr.

Procédure générique:

- Prerequis: Un serveur web Apache, PHP et une base de donnée (MySQL ou PostgreSQL) tourne correctement et le compte login/mot de passe (de la nouvelle base de donnée ou d'administration du serveur) est connu (sinon les demander à l'hébergeur).

- Niveau: Utilisateurs avec quelques notions d'administration Web and base de donnée. Maitrise d'un outil de transfert de fichier (FTP, SFTP, ...) pour uploader les fichiers sur le serveur.

- Procédure:

• Vérifiez que vous avez un serveur Web Apache, PHP et une base de donnée (MySQL ou PostGreSQL) qui fonctionne correctement.

• Vérifiez que vous avez un compte root ou administrateur avec login/mot de passe connu et que ces comptes fonctionnent. Si inconnu, demandez les à votre hébergeur.

• Récupérer l'archive de la dernière version stable de Dolibarr et décompressez la localement..

• Uploadez tout le contenu du répertoire dans le répertoire racine de votre site web, par exemple par FTP en mode binaire. NB : seul le contenu de htdocs est nécessaire au fonctionnement de dolibarr)

• Créez un répertoire nommé "documents", dans cette racine, qui servira à sauver tous les documents générés et stockés par Dolibarr (factures PDF, images uploadées, ...). Le serveur web doit avoir les permissions d'écrire dedans. Vous pouvez attribuer ces permission avec un client FTP.

• Maintenant appeler la page principale index.php de dolibarr avec votre navigateur.

• Suivez les instructions pas à pas du processus d'installation.

• Pour des raisons de sécurité, une fois l'installation terminée, de créer un fichier install.lock dans le répertoire de Dolibarr. Ceci verrouillera l'appel au processus d'installation (il vous faudra supprimer ce fichier pour permettre les mise à jour). Si ceci n'est pas fait, Dolibarr vous affichera un warning lorsque vous êtes logués comme administrateur.

Exemple de tutoriel d'installation assez complet

Comment installer un Dolibarr PARFAITEMENT fonctionnel chez l'hébergeur GANDI ?

Sur un hébergeur SaaS ou Cloud

Dolibarr est aussi disponible en version "pré-installée" chez de nombreux hébergeurs payants, fournissant des instances hébergées "prêtes à l'emploi".

Voir la page Solutions Cloud pour Dolibarr ERP CRM.

Dolibarr peut aussi être installé manuellement sur toute plateforme Cloud (gratuite ou payante) qui supporte le PHP et Mysql.

Voir la page Installation - Mise à jour

Installation avec Docker

Utiliser l'image docker officielle

Voir le fichier README à https://hub.docker.com/r/dolibarr/dolibarr

Reconstruire son image docker

Pour les administrateurs ayant une expérience de Docker, il est possible d'utiliser les fichiers de build Docker situés dans le référentiel source ici : https://github.com/Dolibarr/dolibarr/tree/develop/build

git clone https://github.com/Dolibarr/dolibarr/
cd ./dolibarr
git checkout tags/<desiredrelease>

cd build/docker

docker-compose up

Lisez attentivement le fichier README. À partir de la version 12+, il est recommandé d'utiliser les fichiers Docker intégrés uniquement pour le développement, tandis qu'un dépôt externe : https://hub.docker.com/r/dolibarr/dolibarr est recommandé pour les environnements de production.

Configuration

Premiers paramétrages

Voir la page Configuration/Paramétrage.

Configurer une connexion LDAP

Si vous désirez utiliser LDAP: Voir Installer et configurer OpenLDAP.

Importer des données externes

Pour cette opération, consulter la page Imports_de_masse.

Procédure de mise à jour

Ce chapitre décrit le processus pour mettre à niveau une installation existante de Dolibarr d'une ancienne version vers une autre. Le processus est le même quel que soit la version depuis laquelle vous venez et la version vers laquelle vous allez, mais sera différent selon la distribution ou système d'exploitation utilisé pour votre première installation. Il est recommandé d'utiliser le même type de distribution pour la mise à jour que celle utilisée pour la première installation.

Sauvegarde avant mise à jour

Avant de faire une mise à jour, il est recommendé de faire un sauvegarde de la base de donnée mais aussi des documents, de cette façon même en cas de catastrophe vous ne perdrez pas vos précieuses données https://wiki.dolibarr.org/index.php/Sauvegardes

Note : (facultatif mais recommandé)

Il est préférable de supprimer les anciens script (et les programmes s'ils sont inclus dans l'archive téléchargée) avant de déployer les nouveaux: des anciens fichiers pourraient rester dans la novuelle installation, causant bug ou dysfonctionnement.

Avant d'effacer quoi que ce soit, penser à sauvegarder les scripts spécifiques de votre installation:

• /custom si vous avez des modules externes (dolistore) -> assurez vous que vos modules sont compatibles avec la nouvelle version avant de mettre à jour !
• /conf/conf.php : les principaux paramètres de dolibarr
• Vos modèles et/ou script php personnalisés (il est recommandé de reporter vos modifications dans les nouveaux fichier car les votres sont basées sur l'ancienne version)

Avec DoliWamp (package Windows .exe)

Si vous aviez installé la version de Dolibarr spécifique nommé DoliWamp (qui embarque le serveur Web, PHP et Mysql), la procédure à suivre est celle-ci (Dans tout autre cas, utilisez une des procédures des chapitres suivant):

• Télécharger la nouvelle version de DoliWamp.

• Lancer le .exe et laissez vous guider dans toutes les étapes de migration en cliquant suivant,suivant,... à chaque fois sans rien changer aux valeurs proposées par défaut.

• Au premier accès de Dolibarr, l'application détectera que vous avez une base en version ancienne. Choisissez le menu proposé pour migrer à la version supérieure. Si vous avez fait un saut de plusieurs version, garder le choix proposer de migrer d'une seule version, à la fin le menu vous sera reproposé pour migrer à la suivante et ainsi de suite jusqu'à atteindre la version qui a été installé (par si vous avez installer Dolibarr 3.5 par dessus votre version courante qui était Dolibarr 3.2, choisissez le menu de migration pour passer de 3.2 à 3.3, puis 3.3 à 3.4 puis 3.4 à 3.5).

Avec DoliDeb (package Debian / Ubuntu .deb)

Si vous aviez installé Dolibarr via un packagage Debian-Ubuntu, sa mise a jour se fait simplement de la même manière qu'une première installation. Il suffit d'installer le nouveau package .deb. Par exemple en suivant la procédure Dolibarr pour Ubuntu ou Debian.

• Au premier accès de Dolibarr, l'application détectera que vous avez une base en version ancienne. Choisissez le menu proposé pour migrer à la version supérieure. Si vous avez fait un saut de plusieurs version, garder le choix proposer de migrer d'une seule version, à la fin le menu vous sera reproposé pour migrer à la suivante et ainsi de suite jusqu'à atteindre la version qui a été installé (par si vous avez installer Dolibarr 3.5 par dessus votre version courante qui était Dolibarr 3.2, choisissez le menu de migration pour passer de 3.2 à 3.3, puis 3.3 à 3.4 puis 3.4 à 3.5).

Avec DoliRpm (package Fedora, Redhat, Mandriva, Mageia ou OpenSuse .rpm)

Si vous aviez installé Dolibarr via un packagage rpm, sa mise a jour se fait simplement de la même manière qu'une première installation. Il suffit d'installer le nouveau package .rpm.

• Au premier accès de Dolibarr, l'application détectera que vous avez une base en version ancienne. Choisissez le menu proposé pour migrer à la version supérieure. Si vous avez fait un saut de plusieurs version, garder le choix proposer de migrer d'une seule version, à la fin le menu vous sera reproposé pour migrer à la suivante et ainsi de suite jusqu'à atteindre la version qui a été installé (par exemple si vous avez installé Dolibarr 3.5 par dessus votre version courante qui était Dolibarr 3.2, choisissez le menu de migration pour passer de 3.2 à 3.3, puis 3.3 à 3.4 puis 3.4 à 3.5).

Avec Dolibarr (package standard .zip)

Cette procédure décrit la mise à jour de Dolibarr depuis une ancienne version vers une plus récente par la méthode manuelle, avec la distribution standard.

Cas d'un hébergement où vous disposez d'un accès SSH

• Placez-vous dans le répertoire dans lequel a été installé Dolibarr (le répertoire racine de votre serveur web, par exemple /var/www sous Debian)

$ cd /var/www

• Récupérez l'archive de la nouvelle version (ex: 12.0.4)

$ wget 'https://sourceforge.net/projects/dolibarr/files/Dolibarr ERP-CRM/12.0.4/dolibarr-12.0.4.zip'

• Décompressez l'archive

$ unzip dolibarr.zip

• Recopiez les nouveaux fichiers (qui ont été décompressés dans le répertoire dolibarr-x.y.z) vers le répertoire où vous avez votre ancienne version de Dolibarr. Ceci a pour effet de remplacer les anciens fichiers par les nouveaux tout en conservant les fichiers qui vous sont spécifiques (comme le fichier conf.php ou encore vos modules complémentaires non officiels installés).
• Si vous déplacez ou renommez également le dossier de votre ancienne version de Dolibarr, pensez à modifier les chemins dans le fichier conf/conf.php (sinon vous risquez un fatal error: Cannot redeclare versiontostring)

$ cp -r dolibarr-x.y.z/* dolibarr

• Vous pouvez alors supprimer le répertoire des fichiers sources

$ rm -fr dolibarr-x.y.z

• Lancer Dolibarr dans votre navigateur habituel. Ceci fera apparaître l'assistant de migration: L'application détectera que vous avez une base en version ancienne. Choisissez le menu proposé pour migrer à la version supérieure. Si vous avez fait un saut de plusieurs versions, garder le choix proposé de migrer d'une seule version, à la fin le menu vous sera reproposé pour migrer à la suivante et ainsi de suite jusqu'à atteindre la version qui a été installée (par si vous avez installé Dolibarr 3.5 par dessus votre version courante qui était Dolibarr 3.2, choisissez le menu de migration pour passer de 3.2 à 3.3, puis 3.3 à 3.4 puis 3.4 à 3.5).

ou

Lancer les 3 étapes de migration en ligne de commande:

$ cd htdocs/install
$ php upgrade.php oldx.oldy.oldz x.y.z > output.html
$ php upgrade2.php oldx.oldy.oldz x.y.z > output2.html
$ php step5.php oldx.oldy.oldz x.y.z > output3.html

Note: z doit être "0" car seules les versions majeures ont un script de migration à exécuter.

Plusieurs versions majeures d'écart (vérifié de la 22 à la 24) : lancez les 3 commandes une fois par version majeure, dans l'ordre (22.0.0 → 23.0.0, puis 23.0.0 → 24.0.0). Un seul appel 22.0.0 → 24.0.0 exécute bien les fichiers SQL, mais saute les migrations de données de la version intermédiaire, sans aucune erreur.

En 22, 23 et 24 (testé), si le répertoire documents contient install.lock, créez d'abord un fichier vide upgrade.unlock au même endroit. Pour chaque étape intermédiaire, terminez step5.php par auto upgrade_ suivi de la version visée : sinon step5.php efface upgrade.unlock dès la 1re étape, et l'étape suivante est refusée avec un code retour 0, donc sans que rien ne le signale.

$ touch /chemin/vers/documents/upgrade.unlock
$ php upgrade.php 22.0.0 23.0.0 > etape1.html
$ php upgrade2.php 22.0.0 23.0.0 >> etape1.html
$ php step5.php 22.0.0 23.0.0 auto upgrade_23.0.0 >> etape1.html
$ php upgrade.php 23.0.0 24.0.0 > etape2.html
$ php upgrade2.php 23.0.0 24.0.0 >> etape2.html
$ php step5.php 23.0.0 24.0.0 >> etape2.html
$ rm /chemin/vers/documents/upgrade.unlock

Détail des tests et script complet avec sauvegarde : https://dolix.fr/notes/dolibarr-script-mise-a-jour/

Le code retour sera 0 en cas de succès, 1 en cas d'erreur (voir alors le fichier sortie output.html ou output2.html)

Note: Si vous avez un message signalant que le processus de mise à jour est verrouillé par un fichier install.lock, supprimer ce fichier (il est stocké dans le répertoire racine ou "documents" de Dolibarr) puis rafraîchissez la page.

• Pour des raisons de sécurité nous vous conseillons, une fois la mise à jour terminée, de verrouiller le répertoire d'installation en créant un fichier install.lock dans le répertoire de donnée de Dolibarr. Dans le cas contraire, Dolibarr vous avertira d'un message dans l'interface une fois connecté

$ echo > documents/install.lock
$ chmod 444 documents/install.lock

Cas d'un hébergement sans accès SSH (mutualisé)

Cette procédure a été vérifiée pour les mises à jours mineures de v10.0, soit v10.0.n vers v10.0.m (m > n). Dolibarr est installé sur un hébergement mutualisé que l'on peut paramétrer par une interface dédiée et à laquelle on accède par ftp/sftp.

La mise à jour pourra prendre de 2 à 4 heures en fonction de votre bande passante internet. Dolibarr sera inaccessible à tous les utilisateurs entre les étapes 3 et 6.

Chaque étape doit être réalisée dans l'ordre. L'interruption du processus est possible entre chaque étape.

Étape 1 - Téléchargement de la nouvelle version

Téléchargez l’archive de la nouvelle version sur votre disque local.

Décompressez l’archive de la nouvelle version sur le disque local.

Étape 2 - Sauvegarde de votre installation actuelle

Se reporter à la page Sauvegardes.

À partir de votre interface d'administration Dolibarr, sauvegardez :

• le répertoire /documents,
• la base de donnée.

Les fichiers de sauvegarde créés sont enregistrés dans votre répertoire /documents.

Récupération de la sauvegarde distante (obligatoire, le fichier conf.php sera réutilisé plus tard)

Copier les répertoires distants suivants sur votre disque local :

• /documents,
• /htdocs/conf (pour sauver conf.php).

Étape 3 - Mettre le site hors ligne

Rendez l'accès à Dolibarr impossible à vos utilisateurs. Dans la plupart des cas, votre hébergement permet de rendre votre site hors ligne. Il ne sera plus accessible via un navigateur. Vous aurez toujours accès aux répertoires via votre logiciel ftp.

Étape 4 - Supprimez l'ancienne version sur le serveur

Avec votre logiciel ftp, supprimez les fichiers et répertoires suivants :

• les fichiers à la racine de votre répertoire distant,
• install.lock dans le répertoire /documents (s'il existe),
• les répertoires :
  • /build,
  • /dev,
  • /doc,
  • /htdocs,
  • /scripts.

Il ne doit plus rester que le répertoire /documents dans votre espace distant.

Étape 5 - Envoyer les nouveaux fichiers sur le serveur distant

Avec votre logiciel ftp, envoyer :

• tous les fichiers et répertoires de l'archive décompressée de la nouvelle version,
• conf.php de votre sauvegarde dans /htdocs/conf

Étape 6 - Lancer la mise à jour

Remettre votre site en ligne.

Avec votre navigateur, connectez-vous à votre instance Dolibarr avec l'URL que vous utilisez habituellement (généralement : https://monsite.re/htdocs/index.php). Dolibarr détecte la présence de fichiers d'une nouvelle version. Il lance le processus de mise à jour.

À l'issue de ce processus, vous arrivez sur votre page de connexion habituelle. Vous noterez que le numéro de votre nouvelle version sera indiqué au-dessus du formulaire de connexion.

Étape 7 - Opération de sécurité finale

Envoyer install.lock depuis votre sauvegarde dans le répertoire /documents.

Vidéos sur le sujet

Installation en local :

Installation sur serveur distant Infomaniak :

Installation et migration vers V15 en local :