# 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*** :
1. Via l’installeur DoliWamp (méthode recommandée pour débuter)
2. 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.
1. É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
```
1. Éditez le fichier hosts C:\\Windows\\System32\\drivers\\etc\\hosts et ajoutez :
```
127.0.0.1 dolibarr-230.local
```
1. 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**