{{tag>tutoriel}}

====== Dolibarr : installation gratuite chez Amen.fr (hébergement offert) ======

Ce tutoriel montre comment installer **Dolibarr** sur un hébergement gratuit offert par Amen.fr.


===== Introduction =====

<WRAP list-deep>
  - **L'offre de Amen.fr** avec un nom de domaine .fr à un euro et un micro hébergement offert : Voir la vidéo [[https://www.youtube.com/watch?v=BLbTt45e85Y&t=0s]] **Pour vous procurer le pack domaine chez Amen.fr** : [[https://sf66.eu/amenfr]]
  - **Pourquoi pas une installation locale par exemple avec Doliwamp** ?
    - Avec **Doliwamp**, vous aurez du mal à faire évoluer les versions des composants du serveur ou de **Dolibarr**.
    - **Il est conseillé de faire une installation sur un serveur distant** comme le micro hébergement proposé par Amen.fr.
    - Mais une installation locale permet les tests de mise à jour, de plugins, etc. : les tests de sauvegarde restauration, etc. devront être faits sur une installation locale.
    - Mais cela pourra intervenir dans un second temps et vous pourrez utiliser l'hébergement de Amen.fr pour vous familiariser avec l'utilisation d'un serveur web distant.
  - **Quelle version installer ?** :
    - Dernière version disponible à l'heure de ce tuto : version 13.
    - Mais nous allons installer une version antérieure (la dernière version mineure de la version 12) pour ne pas subir d'éventuels bugs résiduels de la dernière version.
  - **Les étapes de la procédure d'installation** :
    - **Créer la base de données chez Amen.fr**
    - **Télécharger Dolibarr** (avant-dernière version) sur le site github de dolibarr
    - **Via FTP, transférer sur le serveur de Amen.fr les fichiers téléchargés**, préalablement décompressés
    - **Installer Dolibarr** en se connectant au domaine
    - **Verrouiller l'installation** pour empêcher une installation tierce éventuellement malveillante
</WRAP>

===== Pré-requis =====


===== Première étape : Créer la base de données chez Amen.fr =====

<WRAP list-deep>
  - **Connectez-vous sur l'interface cpanel de Amen.fr** avec vos identifiants :{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-001.png?400 |}}
  - **dans la rubrique base de données**, cliquez sur l'**assistant de base de données** :{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-002.png?400 |}}
  - **Donnez un nom de base de données** :
    - le nom de la base de données est toujours précédé de l'identifiant cpanel (lisible en haut à droite)
    - Principe de nommage :
      - **deux premières lettres : db** comme dolibarr
      - **deux suivantes : an** (première et dernière lettres du nom de domaine acop.phon)
      - **et 1** (c'est la première installation de dolibarr que je fais)
    - **Cliquez sur <key>Étape suivante</key>**{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-003.png?400 |}}
  - **Créez l'utilisateur** de la base de données :
    - **Nom d'utilisateur** : le même que celui de la base de données, avec dban1
    - **Mot de passe**
    - **Confirmation du mot de passe**
    - **Cliquez sur <key>Créer un utilisateur</key>**{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-004.png?400 |}}
  - **attribuer les droits à l'utilisateur** :
    - Cochez **TOUS LES PRIVILÈGES** pour lui donner tous les droits
    - Cliquez sur <key>Étape suivante</key>{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-005.png?400 |}}
  - **Terminer la tâche** :
    - la base de données et l'utilisateur ont été créés
    - Cliquez sur le lien **Revenez aux bases de données MySQL** :{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-006.png?400 |}}
  - **Vérifier dans la liste des bases de données** de l'interface cpanel : je trouve la base de données que j'ai créée, l'utilisateur avec tous les droits, donc c'est ok{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-007.png?400 |}}
</WRAP>

===== Autres étapes =====

==== Deuxième étape : Télécharger Dolibarr ====

<WRAP list-deep>
  - **Sur le navigateur, ouvrez** [[https://github.com/Dolibarr/dolibarr/]]
    - **on est automatiquement sur la dernière branche** en cours de développement{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-008.png?400 |}}Or on ne veut pas la branche de développement, mais utiliser la version 12.
    - **Deux façons d'y accéder** : cliquez sur la flèche de l'onglet **develop** et
      - **soit cliquez sur Branches** puis sur 12, ce qui donne la dernière version mineure de la version majeure 12{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-009.png?400 |}}
      - **ou cliquez sur tag**, ce qui liste de toutes les versions mineures : cliquez sur la version que vous voulez télécharger (12.0.4){{ :tutoriel:erp-crm:dolibarr:install:amen:amen-010.png?400 |}}
  - **Dans le répertoire de téléchargement, dézippez le fichier**, ce qui crée le répertoire décompressé de dolibarr 12.0.4
</WRAP>

==== Troisième étape : transférer les fichiers via FTP ====

Ayez sous la main :
  * base de données
  * mot de passe

<WRAP list-deep>
  - **Ouvrez Filezilla**
  - **Connectez-vous au serveur de amen.fr** : collez l'URL, le nom d'utilisateur et le mot de passe et cliquez sur <key>Connexion rapide</key>
    - le site distant (l'hébergement chez amen.fr) s'affiche sur la droite
    - et, sur la gauche, le site local, c'est-à dire le répertoire de transfert contenant dolibarr{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-011.png?400 |}}
  - **Transférez le contenu du répertoire htdocs du site local vers le répertoire public_html de l'hébergement amen.fr** :
    - sur le site distant, double cliquez sur public_html pour vous positionner dans ce répertoire
    - sur le site local :
      - sélectionnez tous les répertoires et fichiers
      - un clic droit, envoyer : l'intégralité du contenu du répertoire htdocs se transfère dans le répertoire public_html{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-012.png?400 |}}
    - sur le site distant, **Créez le répertoire /dolibarr/documents** en dehors de ce qui est accessible au web :
      - Remontez dans l'arborescence de l'hébergement jusqu'à la racine (/ ou home)
      - Avec un clic droit, créez un répertoire nommé dolibarr
      - et dans ce répertoire, un répertoire documents{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-013.png?400 |}}
</WRAP>

==== Quatrième étape : Installer Dolibarr ====

<WRAP list-deep>
  - Dans votre navigateur, ouvrez la page [[https:accope.fun/install]] pour lancer l'installation :
    - **Langue par défaut** : laisser **Détection automatique** ((Vous pourriez choisir une autre langue si vous voulez))
    - **Cliquez sur <key>Étape suivante</key>**{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-014.png?400 |}}Il fait un certain nombre de vérifications
  - **Ici, toutes les coches sont vertes sauf** : **Votre installation de php ne supporte pas les fonctions intl** :{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-015.png?400 |}}
    - **Pour régler ce problème de php** sur l'hébergement de amen.fr :
      - **Retournez dans cPanel**
      - **Dans le paragraphe LOGICIEL**, ((descendez dans la page)) cliquez sur **Sélectionner une version de PHP**{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-016.png?400 |}}
      - **Cherchez l'extension intl** : elle n'est pas cochée, ce qui veut dire qu'elle n'est pas installée ((si vous avez un jour besoin d'installer d'autres fonctions php, c'est ici que ça se trouve donc dans cpanel, quel que soit l'hébergeur))
      - **Cochez intl pour l'activer**{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-018.png?400 |}}La petite fenêtre verte en haut affiche : **Success module intl saved**
    - Revenez sur l'installation : toutes les coches sont vertes{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-019.png?400 |}}Si vous avez d'autres coches rouges, il faut les corriger avant d'installer dolibarr, sinon dolibarr pourrait ne pas fonctionner correctement.
    - Cliquez sur <key>Démarrer</key>
  - **La page de configuration de l'installation** s'affiche. Vérifiez et modifiez ce qui est nécessaire :
    - **Serveur web** :
      - **Répertoire contenant les pages web** : /home/mon_identifiant/public_html -> c'est bien ce qui était dans Filezilla
      - **Répertoire devant contenir les documents générés (PDF, etc.)** ((Si on ne l'avait pas créé, automatiquement ce répertoire-là serait créé dans public_html)) : on a créé le répertoire documents non pas dans public_html mais dans un répertoire en dehors de ce qui est accessible sur le web et qu'on l'a appelé dolibarr -> modifiez le nom du répertoire, soit ici : .../dolibarr/documents
      - **URL racine** : laisser https://accope.fun
      - Cochez **Forcer les connexions sécurisées HTTPS** : quand quelqu'un tape http://accope.fun, automatiquement il va être redirigé sur la version https. Si vous ne cochez pas ça, ça ne sera pas fait et il se connectera en http non sécurisé. Ce n'est pas souhaitable car la première chose qu'on saisit sur dolibarr quand on se connecte sur acop.phone, c'est un identifiant et un mot de passe. C'est pour ça que systématiquement j'active https sur l'hébergement et je coche ici cette case pour forcer l'utilisation d' https.{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-020.png?400 |}}
    - **Base de données Dolibarr** :
      - **Nom de la base de données** : celui qu'on a rentré lors de la création de la base de données
      - **Type du pilote** : mysqli
      - **Serveur de base de données** : localhost
      - **Port** : 3306
      - **Préfixe des tables** : le changer pour une question de sécurité ; ici, an_ (première et dernière lettre)
      - **Créer la base de données** : ne pas cocher puisque la base de données est déjà créée
      - **Identifiant** : celui rentré lors de la création de la base de données
      - **Mot de passe** : celui rentré lors de la création de la base de données
      - **Créer le propriétaire ou lui affecter les droits à la base** : pas la peine de cocher puisqu'on a déjà créé l'utilisateur et qu'on lui a déjà attribué les droits
      - **Cliquez sur <key>Étape suivante</key>**{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-21.png?400 |}}
  - **toutes les coches sont vertes**, on va pouvoir continuer
    - **S'il y a une coche rouge**, revenez en arrière et modifiez une information que vous avez certainement mal renseignée
    - **Cliquez sur <key>Étape suivante</key>**{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-22.png?400 |}}
  - **Vérification de connexion à la base de données** :
    - la table est prête, on peut passer maintenant directement à l'installation.
    - **Cliquez sur <key>Étape suivante</key>**{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-23.png?400 |}}
  - **Création du compte administrateur** de Dolibarr :
    - **Identifiant** : identifiant de l'administrateur de Dolibarr = un nom aléatoire + admin, ici **carlitadmin** (pour un utilisateur, le même nom + util pour bien différencier le compte administrateur et le compte utilisateur)
    - **Mot de passe** : mot de passe de l'administrateur de dolibarr (Pour le mot de passe, évitez les caractères spéciaux)
    - **Vérification du mot de passe** : confirmez le mot de passe
    - **Cliquez sur <key>Étape suivante</key>**{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-24.png?400 |}}
  - Cliquez sur **Acéder à Dolibarr (espace de configuration)** pour commencer la configuration de Dolibarr.{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-25.png?400 |}}
  - **L'identifiant de l'administrateur est automatiquement renseigné**, il ne reste qu'à renseigner le mot de passe et à cliquer sur <key>SE CONNECTER</key> :{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-26.png?400 |}}
  - Vous êtes connecté à l'administration de Dolibarr que vous venez d'installer sur l'hébergement amen.fr{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-27.png?400 |}}
</WRAP>

==== Cinquième étape : verrouiller l'installation ====

Pour verrouiller l'installation, il faut mettre dans le répertoire documents un fichier nommé** install.lock**.

  - Dans Filezilla, allez dans le répertoire /dolibarr/documents
  - Faîtes un clic droit -> **créer un nouveau fichier**{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-28.png?400 |}}
  - que vous appelez install.lock et cliquez sur <key>ok</key>{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-29.png?400 |}}

Le fichier est présent : les installations ou les mises à jour sont maintenant verrouillées.

Si vous voulez par la suite faire une mise à jour, il faudra supprimer ce fichier install.lock.

C'est une mesure de sécurité et on peut d'ailleurs le vérifier en retournant sur le domaine :
  - ouvrez une nouvelle fenêtre,
  - tapez accope.fun/install : un message indique que le répertoire d'installation et de mise à jour est verrouillé.{{ :tutoriel:erp-crm:dolibarr:install:amen:amen-30.png?400 |}}

===== Conclusion =====

===== Problèmes connus =====

===== Voir aussi =====

  * **(fr)** [[https://www.youtube.com/watch?v=cF4FjLmv90s]]

----
//Basé sur << [[https://www.youtube.com/watch?v=cF4FjLmv90s|DOLIBARR : INSTALLATION gratuite chez AMEN.FR (hébergement OFFERT) (France / 2021)]] >> par Stéphane Brunet.//