03. INSTALLATION
3.1 Introduction
Dolibarr™ est installable sur un serveur LAMP ( Linux, Apache, MySQL, PHP ). Ce chapitre présente deux méthodes d’installation en local sous Windows :
Via l’installeur DoliWamp (méthode recommandée pour débuter) Via les sources GitHub avec XAMPP (méthode pour les développeurs)
3.2 Installation via DoliWamp
TÉLÉCHARGEMENT :
Commencez par récupérer les sources sur SourceForge : https://sourceforge.net/projects/dolibarr/files/ Cliquez sur le lien Dolibarr installer for Windows (DoliWamp), puis sur le tag de la dernière version stable.
Figure 3.1 – Page de téléchargement sur SourceForge ÉTAPES DE L'INSTALLATION : Récupérez et lancez l’exécutable DoliWamp. Suivez toutes les étapes de l’assistant d’installation pas à pas, en cliquant sur les boutons Oui, Suivant ou Installer. Étape 1 — Démarrage de l’assistant Figure 3.2 – Étape 1 : démarrage de l’assistant DoliWamp Étape 2 — A ccord de licence Figure 3.3 – Étape 2 : accord de licence Étape 3 — Dossier d'installation Figure 3.4 – Étape 3 : dossier d’installation Étape 4 — Composants à installer Figure 3.5 – Étape 4 : composants à installer Étape 5 — Dossier dans le menu Démarrer Figure 3.6 – Étape 5 : dossier dans le menu Démarrer Étape 6 — Résumé avant installation Figure 3.7 – Étape 6 : résumé avant installation Étape 7 — Autorisation d’accès réseau Autorisez l’accès naturellement lorsque le pare-feu Windows vous le demande. Figure 3.8 – Étape 7 : autorisation du pare-feu Windows Étape 8 — Fin de l’installation Windows Figure 3.9 – Étape 8 : installation DoliWamp terminée SUITE DE L'INSTALLATIONDANS L'INTERFACE WEB : Le reste de l’installation se déroule dans l’interface web. DoliWamp ouvre automatiquement le navigateur sur l’assistant d’installation Dolibarr™.
3.3 Installation à partir des sources GitHub (XAMPP)
Cette méthode est destinée aux développeurs qui souhaitent travailler directement avec les sources du projet.
PRÉREQUIS :
Un serveur LAMP local, par exemple XAMPP (https://www.apachefriends.org/) Git Bash installé (https://git-scm.com/)
CLONNAGE DU DÉPOTS :
Placez-vous dans le dossier htdocs de XAMPP, faites un clic droit et lancez Git Bash.
Figure 3.11 – Lancement de Git Bash via le menu contextuel
Utilisez la ligne de commande suivante pour cloner le dépôt :
git clone git@github.com:Dolibarr/dolibarr.git
Figure 3.12 – Commande git clone dans Git Bash
Figure 3.13 – Progression du clonage
SÉLÉCTION DE LA VERSION :
Une fois le téléchargement terminé, déplacez-vous dans le dossier dolibarr et basculez sur la version souhai- tée :
cd dolibarr
git checkout 23.0
Renommez ensuite le dossier pour le distinguer des autres versions, par exemple dolibarr-230.
CONFIGURATION D'UN VirtualHost XAMPP :
Pour accéder directement à Dolibarr™ sans ajouter /htdocs/ dans l’URL, créez un VirtualHost Apache.
Éditez le fichier C:\xampp\apache\conf\extra\httpd-vhosts.conf et ajoutez :
ServerName dolibarr-230.local
DocumentRoot "C:/xampp/htdocs/dolibarr-230/htdocs"
AllowOverride All
Require all granted
Éditez le fichier hosts C:\Windows\System32\drivers\etc\hosts et ajoutez :
127.0.0.1 dolibarr-230.local
Redémarrez Apache depuis le panneau de contrôle XAMPP.
Vous pouvez maintenant accéder à votre instance via : http ://dolibarr-230.local
PAGE D'INDEX XAMPP PERSONNALISÉE (bonus) :
Pour avoir une page d’accueil XAMPP listant automatiquement vos VirtualHosts, remplacez le contenu de index.php à la racine de htdocs par :
Accueil XAMPP
Accueil XAMPP
Mes projets (VirtualHosts)
Figure 3.14 – Page d’accueil XAMPP personnalisée avec liste des VirtualHosts
CRÉATION DE LA BASE DE DONNÉES :
Ouvrez phpMyAdmin (http://localhost/phpmyadmin/) et créez une nouvelle base de données, par exemple dolibarr-230.
Figure 3.15 – Création de la base de données dans phpMyAdmin
Figure 3.16 – Base de données créée
3.4 Assistant d’installation web de Dolibarr™
Que vous ayez utilisé DoliWamp ou l’installation depuis les sources, la suite de la configuration se déroule dans l’interface web de Dolibarr™.
Étape 1 — Vérification de l’environnement
L’assistant vérifie automatiquement la compatibilité de votre environnement (version PHP, extensions re- quises, droits sur les dossiers…).
Figure 3.17 – Étape 1 de l’assistant web : vérification de l’environnement
Passez à l’étape suivante une fois toutes les vérifications validées.
Étape 2 — Configuration de la base de données
Important : Le nom de la base de données doit correspondre exactement à celle créée précédemment (ici : dolibarr-230).
Figure 3.18 – Étape 2 : configuration de la connexion à la base de données
Étape 3 — Installation des tables
L’installation des tables SQL peut prendre quelques minutes. Attendez l’affichage complet de la page suivante avant de poursuivre.
Figure 3.19 – Étape 3 : installation des tables en cours
Figure 3.20 – Progression de l’installation des tables
Étape 4 — Ping anonyme
Dolibarr™ vous propose d’effectuer un ping anonyme pour permettre à la fondation de comptabiliser le nombre d’installations actives. Cette étape est facultative.
Figure 3.21 – Option de ping anonyme pour la fondation Dolibarr
Étape 5 — Création du compte administrateur
Renseignez un identifiant et un mot de passe pour le compte administrateur de votre instance Dolibarr™.
Figure 3.22 – Création du compte administrateur
Figure 3.23 – Installation terminée — accès à Dolibarr
Astuce : Notez bien vos identifiants administrateur. En cas de perte, il est possible de les réinitialiser directement en base de données, mais cela nécessite un accès à phpMyAdmin ou à la ligne de commande MySQL.