Guide étape par étape : comment installer Dolibarr sur un environnement d'hébergement cPanel

Table des Matières

1. Introduction

2. Pourquoi installer Dolibarr sur cPanel ?

3. Conditions préalables avant l'installation

4. Étape 1 : Téléchargement du dernier package Dolibarr

5. Étape 2 : Téléchargement de Dolibarr sur votre compte cPanel

6. Étape 3 : Création d'une base de données MySQL via cPanel

7. Étape 4 : Définition des autorisations de fichiers correctes

8. Étape 5 : Exécution du programme d'installation de Dolibarr

9. Étape 6 : Configuration post-installation

10. Étape 7 : Sécurisation de votre instance Dolibarr

11. Étape 8 : Installation de modules supplémentaires

12. Étape 9 : Automatisation des sauvegardes et des mises à jour

13. Erreurs courantes et comment les résoudre

14. Réflexions finales

1. Introduction

Dolibarr ERP & CRM est une suite logicielle open source en ligne qui aide les entreprises à gérer toutes leurs opérations, de la facturation et de la comptabilité à la gestion des stocks, en passant par les ressources humaines et la relation client. Elle est particulièrement appréciée pour sa structure modulaire, sa simplicité d'utilisation et son adaptabilité aux PME, aux indépendants et aux ONG.

Si vous souhaitez installer Dolibarr sur Hébergement cPanel—l’un des types de plateformes d’hébergement Web les plus courants et les plus accessibles—ce guide vous guidera à travers chaque étape du processus en termes clairs et non techniques.

Ce tutoriel suppose zéro connaissance du développeur mais est suffisamment complet pour prendre en charge les utilisateurs plus avancés qui souhaitent optimiser et sécuriser leur déploiement Dolibarr.

2. Pourquoi installer Dolibarr sur cPanel ?

cPanel est un panneau de contrôle d'hébergement web très répandu qui simplifie la gestion des serveurs via une interface web. Il est fréquemment proposé par les hébergeurs mutualisés et intègre des outils pour la gestion des fichiers, la création de bases de données, le contrôle de domaine et le déploiement de logiciels.

Avantages de l'utilisation de cPanel pour Dolibarr :

• Aucune expertise en ligne de commande n'est requise

• Téléchargement de fichiers et configuration de base de données faciles

• Plans d'hébergement abordables

• Accès centralisé aux e-mails, aux sauvegardes et aux domaines

• Compatibilité avec PHP et MySQL (technologies de base de Dolibarr)

L'installation de Dolibarr sur cPanel est un excellent choix pour les startups, les petites entreprises et les consultants qui souhaitent héberger leur système ERP de manière abordable et fiable sans louer un VPS ni gérer un serveur cloud.

3. Conditions préalables à l'installation

Avant de commencer, vous aurez besoin des éléments suivants :

• Accès à un compte d'hébergement cPanel

• PHP version 7.4 ou plus (Dolibarr 15+ nécessite PHP 7.4+, les versions plus récentes nécessitent PHP 8.0+)

• Prise en charge des bases de données MySQL ou MariaDB

• Gestionnaire de fichiers ou accès FTP

• Compréhension de base de l'utilisation des outils cPanel

Extensions PHP recommandées :

Assurez-vous que ces extensions PHP sont activées sur votre serveur cPanel :

• gd

• mbstring

• curl

• intl

• zip

• pdo_mysql

• xml

• json

• fileinfo

Vous pouvez les vérifier et les activer via cPanel > Sélectionner la version PHP > Extensions (varie selon l'hôte).

4. Étape 1 : Téléchargement du dernier package Dolibarr

Commencez par télécharger la dernière version stable de Dolibarr depuis le site officiel :

👉 https://www.dolibarr.org/downloads/

Choisissez le Archive « .zip » pour l'installation sur cPanel.

Sauvegarder le fichier sur votre ordinateur.

Conseil : utilisez toujours la source officielle pour éviter les fichiers corrompus ou malveillants.

5. Étape 2 : Téléchargement de Dolibarr sur votre compte cPanel

Option 1 : Utilisation du gestionnaire de fichiers

1. Connectez-vous à votre tableau de bord cPanel.

2. Accédez à Gestionnaire de fichiers.

3. Accédez au dossier dans lequel vous souhaitez installer Dolibarr (généralement public_html ou un sous-dossier comme public_html/erp/).

4. Cliquez à nouveau Télécharger une présentation , Sélectionnez l' .zip fichier que vous avez téléchargé.

5. Après le téléchargement, faites un clic droit sur le fichier ZIP et choisissez Extraction.

Cela créera un répertoire (par exemple, dolibarr-xx.x.x). Vous pouvez renommer ce dossier en quelque chose de plus propre comme dolibarr or erp.

Option 2 : Utilisation du FTP (FileZilla)

Si vous préférez FTP, connectez-vous à votre compte d'hébergement et téléchargez manuellement le dossier Dolibarr décompressé dans le répertoire souhaité.

6. Étape 3 : Création d'une base de données MySQL via cPanel

1. Retour à la tableau de bord principal de cPanel.

2. Cliquez sur Bases de données MySQL®.

3. Sous « Créer une nouvelle base de données », saisissez un nom et cliquez sur Créer une base.

4. Faites défiler jusqu'à « Utilisateurs MySQL ». Créez un nouvel utilisateur et définissez un mot de passe sécurisé.

5. Sous « Ajouter un utilisateur à la base de données », sélectionnez votre utilisateur et votre base de données, puis cliquez sur Ajouter.

6. Sur l'écran suivant, cochez Tous les privilèges, puis clique Faire des changements.

Prenez note de :

• Nom de la base de données

• Utilisateur de la base de données

• Mot de passe

Vous en aurez besoin à l’étape suivante.

7. Étape 4 : Définition des autorisations de fichiers correctes

Des autorisations appropriées garantissent que Dolibarr peut écrire dans les répertoires nécessaires :

1. In Gestionnaire de fichiers, faites un clic droit sur les répertoires suivants et définissez les autorisations sur 755:

• /documents/

• /conf/

• /htdocs/custom/ (si vous prévoyez d'utiliser des modules personnalisés)

2. Si l'assistant d'installation se plaint ultérieurement des autorisations d'écriture, définissez-les temporairement sur 775, puis revenez à 755 après la configuration.

8. Étape 5 : Exécution du programme d'installation de Dolibarr

1. Ouvrez votre navigateur et accédez à l'URL où vous avez téléchargé Dolibarr. Par exemple :

2. Le programme d’installation vérifiera votre environnement serveur.

3. Cliquez à nouveau Commencer or Étape suivante, selon votre version.

4. Saisissez les détails de la base de données que vous avez créée à l’étape 3.

5. Mettre en place le compte administrateur principal (il s'agit de votre superutilisateur ERP) :

• Nom d'utilisateur

• Mot de passe

• Email

6. Cliquez pour terminer l'installation. Dolibarr :

• Créer les tables de base de données requises

• Définir les paramètres par défaut

• Finalisez votre instance

7. Une fois terminé, le système vous proposera supprimer ou renommer le /install/ dossierUtilisez le Gestionnaire de fichiers pour le supprimer ou le renommer afin d'empêcher la réinstallation.

9. Étape 6 : Configuration post-installation

Une fois Dolibarr installé, vous serez redirigé vers le tableau de bord de l'ERP après connexion. Avant de commencer à utiliser le système, il est important d'effectuer plusieurs étapes. étapes de configuration initiale.

Définir la langue et la région par défaut

Accédez à:
Accueil > Configuration > Affichage > Langues
Choisissez votre langue préférée (par exemple, anglais, français, arabe) et activez-la.

Ensuite aller à:
Accueil > Configuration > Divers > Paramètres régionaux
Définissez votre:

• Pays

• fuseau horaire

• Format de date

• Formatage des nombres (séparateurs décimaux/de milliers)

Configurer le profil de l'entreprise

Définissez les informations de votre entreprise dans :
Accueil > Configuration > Entreprise/Organisation

Remplir:

• Nom légal

• TVA intracommunautaire

• Logo et branding

• Adresse enregistrée

• Début de l'exercice financier

Ces informations apparaîtront sur tous les documents officiels tels que les factures, les propositions et les rapports.

10. Étape 7 : Sécurisation de votre instance Dolibarr

La sécurité est essentielle, surtout sur les plateformes d'hébergement mutualisé comme cPanel. Voici quelques étapes essentielles pour sécuriser votre ERP Dolibarr.

Supprimer le répertoire d'installation

Accédez au Gestionnaire de fichiers et supprimez définitivement le /install/ répertoire de votre dossier Dolibarr.

Restreindre l'accès au /documents/ Dossier

Créer un .htaccess fichier à l'intérieur /documents/ avec ce qui suit:

Cela empêche l’accès direct au Web aux documents téléchargés.

Activer HTTPS

Utiliser cPanel Chiffrons Outil SSL pour installer un certificat SSL pour votre domaine.

Mettre à jour Dolibarr conf.php d'utiliser des URL HTTPS si nécessaire. Cela empêche le détournement de cookies et de sessions.

Définir correctement les autorisations de fichiers

Après l'installation, assurez-vous que les répertoires sensibles tels que /conf/ sont mis à chmod 755 ou plus strict. Ne leur laissez pas d'autorisations d'écriture.

Mettre à jour les paramètres PHP

Via cPanel > Sélectionner la version PHP > Options, considérer ce qui suit:

• memory_limit = 256M

• post_max_size = 32M

• upload_max_filesize = 32M

• max_execution_time = 120

Ils garantiront que les opérations lourdes telles que la génération de PDF et les téléchargements de fichiers volumineux n'échoueront pas.

11. Étape 8 : Installation de modules supplémentaires

La puissance de Dolibarr réside dans son architecture modulaire. Vous pouvez installer des modules supplémentaires pour bénéficier de fonctionnalités telles que :

• RH et Paie

• Services de gestion d’inventaire

• Suivi de projet

• GRC avancé

• Facturation localisée

Installation de modules à partir d'un fichier ZIP

1. Téléchargez le module à partir d'une source fiable (par exemple, Dolistore).

2. Accédez à cPanel > Gestionnaire de fichiers > /htdocs/custom/

3. Téléchargez et extrayez le fichier ZIP du module ici.

4. Dans Dolibarr, allez à Accueil > Configuration > Modules/Applications

5. Recherchez votre nouveau module dans la liste et cliquez sur Activer

Assurez-vous que tout module tiers est compatible avec votre version de Dolibarr et votre configuration PHP.

12. Étape 9 : Automatisation des sauvegardes et des mises à jour

Sauvegardes automatisées dans cPanel

Utilisez le cPanel > Assistant de sauvegarde ou mettre en place cron emplois pour automatiser les sauvegardes de bases de données et de fichiers.

Vous pouvez également:

• Téléchargez le /htdocs/conf/ et /documents/ dossiers

• Exporter la base de données MySQL en utilisant phpMyAdmin

Mettre à jour Dolibarr en toute sécurité

Lorsqu'une nouvelle version de Dolibarr est publiée :

1. Sauvegardez tout

2. Vérifier la compatibilité des modules

3. Suivez la documentation de mise à niveau

4. Remplacez les fichiers principaux et exécutez le script de mise à niveau

Ne pas écraser le /documents/ or /conf/ dossiers lors des mises à niveau. Effectuez toujours des tests dans un environnement de test, si possible.

13. Erreurs courantes et comment les résoudre

Même avec la meilleure configuration, des erreurs peuvent survenir. Voici les problèmes courants et leurs solutions.

Écran vide lors de la connexion

Cause: Erreur PHP, probablement due à des extensions manquantes.
Correction: Vérifiez error_log dans cPanel ou activer le rapport d'erreurs dans conf.php.

Impossible de se connecter à la base de données

Cause: Informations d'identification de base de données incorrectes ou nom d'hôte incorrect.
Correction: Vérifiez le nom de la base de données, l'utilisateur et le mot de passe dans conf.php.

Le module ne s'affiche pas après le téléchargement

Cause: Chemin de dossier incorrect ou structure de module non valide.
Correction: Assurez-vous que le dossier du module est correctement placé sous /htdocs/custom/ et contient un mod*.php fichier.

Les PDF ne sont pas générés

Cause: Extensions PHP manquantes (par exemple, gd, mbstring) ou problème d'autorisations.
Correction: Activez les extensions requises dans cPanel et définissez les autorisations correctes pour /documents/.

403 Interdit sur /documents/

Cause: Accès au dossier sensible bloqué (ce qui est bien).
Correction: Si les fonctions internes ne peuvent pas y écrire, ajustez les autorisations (755) ou la propriété (par exemple, nobody, www-data) via l'équipe d'assistance de votre hébergeur.

14. Réflexions finales

Installer Dolibarr sur cPanel est une solution pratique et accessible pour les entreprises souhaitant un contrôle total sur leur ERP sans avoir besoin d'un serveur dédié ni de connaissances Linux avancées. Grâce aux étapes décrites dans ce guide, vous pourrez disposer d'une instance Dolibarr entièrement opérationnelle, sécurisée et évolutive en quelques heures seulement.

Voici ce que vous gagnez avec cette configuration :

• Un ERP open source adapté à vos besoins précis

• Infrastructure abordable utilisant l'hébergement partagé

• Flexibilité pour étendre les fonctionnalités grâce à des modules certifiés

• Accès sécurisé avec contrôle total des données

• Compatibilité avec les outils standards comme phpMyAdmin, FTP, SSL et les tâches cron

Que vous soyez une petite entreprise en démarrage, une PME établie numérisant ses processus ou un consultant déployant un ERP pour ses clients, cPanel + Dolibarr offre une base stable et évolutive Pour la croissance.