Mettre à jour Dolibarr ERP/CRM est un processus essentiel pour maintenir la sécurité, les performances et les fonctionnalités de votre système de gestion d’entreprise. Avec la version 19.0.1 qui apporte de nombreuses améliorations et corrections par rapport à la 17.0.0, de nombreux utilisateurs souhaitent effectuer la mise à jour. Cependant, cette opération doit être menée avec précaution afin d’éviter toute perte de données, interruption de service ou problèmes de compatibilité.

Ce guide détaillé vous accompagne pas à pas pour mettre à jour Dolibarr de la version 17.0.0 à 19.0.1 de manière sûre et efficace. Que vous soyez administrateur système ou chef d’entreprise technique gérant votre propre installation, cet article vous permettra de procéder à la mise à jour en toute sérénité.

Comprendre les changements entre les versions 17.0.0 et 19.0.1

Avant de commencer, il est important de connaître les nouveautés apportées par les versions 18.x et 19.x. Ces versions incluent des modifications majeures au niveau des modules, du noyau, de la sécurité et de l’interface utilisateur.

Exemples d’améliorations :

• Capacités API REST améliorées

• Module point de vente (POS) enrichi

• Refonte des modèles d’e-mails et documents

• Meilleure compatibilité avec PHP 8.x

• Nouvelles permissions et correctifs de sécurité

• Mises à jour de bibliothèques tierces

Consultez les journaux de modifications officiels sur dolibarr.org pour vérifier si certaines fonctions que vous utilisez sont concernées par des changements ou suppressions.

Étape 1 : Vérifier les prérequis système pour Dolibarr 19.0.1

Dolibarr 19.0.1 nécessite des versions spécifiques de PHP, MySQL/MariaDB et Apache/Nginx. Une mise à jour sans vérification préalable peut casser votre installation.

Prérequis :

• PHP : 7.4 à 8.2 (recommandé : 8.1+)

• MySQL : 5.7+ ou MariaDB 10.3+

• Apache 2.4+ ou Nginx avec PHP-FPM

• Espace disque : au moins 1 Go libre

Utilisez la ligne de commande ou phpinfo() pour vérifier votre configuration actuelle. Si besoin, mettez à jour votre environnement serveur.

Étape 2 : Sauvegarde complète (fichiers + base de données)

Avant toute mise à jour, réalisez une sauvegarde complète de vos fichiers et de votre base de données.

Sauvegarder les fichiers :

tar -czvf sauvegarde_dolibarr_1700.tar.gz /var/www/html/dolibarr

Sauvegarder la base de données :

mysqldump -u root -p dolibarr_db > dolibarr_db_1700.sql

Stockez les sauvegardes sur un autre serveur ou dans le cloud avec un nom incluant la date.

Étape 3 : Tester la mise à jour sur un serveur de préproduction

Ne faites jamais de mise à jour directement sur le serveur de production. Reproduisez l’environnement sur un serveur de test et effectuez une simulation de mise à jour.

• Copiez vos fichiers et base de données sur le serveur test

• Configurez un sous-domaine ou accès local

• Lancez la mise à jour (étapes suivantes)

Cela vous permettra d’identifier à l’avance tout problème potentiel.

Étape 4 : Télécharger le package Dolibarr 19.0.1

Téléchargez la version stable sur le GitHub officiel ou dolibarr.org.

Lien : https://github.com/Dolibarr/dolibarr/releases

Choisissez l’archive .tgz ou .zip selon votre serveur.

Étape 5 : Activer le mode maintenance (optionnel)

Si vous effectuez la mise à jour sur le serveur live :

• Prévenez les utilisateurs

• Restreignez l’accès via .htaccess ou le pare-feu

• Créez un fichier maintenance.html si nécessaire

Cela évite des modifications de données pendant la mise à jour.

Étape 6 : Remplacer les fichiers par la nouvelle version

Conservez :

• htdocs/conf/conf.php

• Le dossier /documents/

• Les modules personnalisés dans /custom/

Étapes :

tar -xvzf dolibarr-19.0.1.tgz
rm -r /var/www/html/dolibarr/*
cp -r dolibarr-19.0.1/htdocs/* /var/www/html/dolibarr/
chown -R www-data:www-data /var/www/html/dolibarr
chmod -R 755 /var/www/html/dolibarr

Étape 7 : Lancer l’assistant de mise à jour

Ouvrez dans votre navigateur :

http://votredomaine.com/install/

Dolibarr détectera l’ancienne version et proposera la migration. Suivez les instructions à l’écran jusqu’à confirmation du succès. Le répertoire /install/ sera ensuite automatiquement supprimé.

Étape 8 : Vérifier le bon fonctionnement après mise à jour

Vérifiez que :

• Les données sont intactes

• Les modules personnalisés fonctionnent

• Les journaux système n’indiquent pas d’erreur

• La génération de documents et les e-mails fonctionnent

• Les opérations courantes (factures, produits) sont valides

Testez également les intégrations externes si vous en avez (API, WooCommerce...).

Étape 9 : Sécurité et journalisation post-mise à jour

• Activez les journaux d’audit

• Sécurisez les permissions utilisateurs

• Renouvelez vos certificats SSL si besoin

• Mettez à jour le pare-feu et surveillez les accès

Étape 10 : Informer les utilisateurs et reprendre l’activité

Une fois tous les tests réalisés :

• Restaurez l’accès normal

• Informez vos utilisateurs des nouveautés

• Proposez des formations ou documents d’accompagnement

Que faire en cas d’erreur ?

Erreurs fréquentes :

• Page blanche / erreur 500 : consultez les logs PHP

• Problèmes base de données : vérifiez la complétion de la migration

• Modules absents : réinstallez ou mettez à jour

Pour revenir en arrière :

• Restaurez les fichiers et la base

• Redémarrez les services web

Conclusion : mettez à jour en toute confiance

Passer de Dolibarr 17.0.0 à 19.0.1 est simple si vous suivez un processus structuré. Grâce à ce guide, vous êtes en mesure de gérer la mise à jour sereinement : sauvegardes, tests, mise à jour, vérification et sécurité.

Règle d’or : ne jamais mettre à jour sans sauvegarde ni test préalable. Avec cette méthode, vous profitez pleinement des avantages de la version 19.0.1 tout en protégeant vos données.