{{tag>tutoriel}}

====== Installation de Dolibarr sur votre poste ou sur un serveur dédié ======

Avec Dolibarr (package standard .zip ou sources Git)

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

  - **Apache**
  - **PHP** 5.6.0+ (avec DateTimeZone.getOffset, php-intl)
  - **un serveur de base de données** (MySQL 5.1+ ou PostgreSQL)
    - **utilisateur root ou admin** principal pour le serveur de base de donnée connu et fonctionnel
  - login/mot de passe d'accès (à une nouvelle base ou au serveur) connus
===== Première étape =====

Sécurisez la base de données.

<WRAP list-deep>
  - **MySql ou MariaDB** sous Linux : si vous venez juste d'installer la base de donnée, le login administrateur est **root.**
    - Pour initialiser le mot de passe, lancez mysql pour modifier le  mot de passe de **root** (Donnez le mot de passe, \q pour quitter) :<cli prompt='$ '>...@...:~ $ mysql -u root -p
Enter password: 
...
<cli prompt='> '>MariaDB [(none)]> grant all privileges on *.* to root@'localhost' identified by 'newrootpass' with grant option;
MariaDB [(none)]> \q</cli>
Bye 
</cli>
    - Pour vérifier :<cli prompt='$ '>...@...:~ $ mysql -u root -p
Enter password: 
...
<cli prompt='> '>MariaDB [(none)]> \q</cli>
Bye 
</cli>Tapez votre nouveau mot de passe et \q pour quitter la session.
  - **Postgresql** :
    - si vous venez juste d'installer la base de donnée PostgreSQL, vous devez d'abord créer un utilisateur administrateur et son mot de passe :
      - Ajoutez la ligne suivante dans le fichier /etc/postgresql/x.x/main/pg_hba.conf (remplacer x.x avec votre version de postgres) :<code - /etc/postgresql/x.x/main/pg_hba.conf>local   all         dolibarrowner    md5</code>
      - Mettez en commentaire la ligne<code - /etc/postgresql/x.x/main/pg_hba.conf>#local   all         all                               ident</code>qui impose que le compte système utilisé pour accéder à la base (sous lequel tourne l'application web), ait le même nom que le compte dans la base (ce n'est jamais le cas). 
    - Puis lancez la commande :<cli prompt='$ '>...@...:~ $ sudo -s -u postgres
createuser dolibarrowner
psql -d template1 -c "alter user dolibarrowner with password 'dolibarrownerpass'"
exit
psql
create database databasename;
grant all privileges on database databasename to dolibarrowner;
ALTER DATABASE databasename OWNER TO dolibarrowner;
\q
sudo /etc/init.d/postgresql restart</cli>
    - Testez la connexion pour l'utilisateur créé :<cli prompt='$ '>...@...:~ $ psql -h localhost -d postgres -U dolibarrowner -W</cli>et entrez le mot de passe dolibarrownerpass et \q pour quitter la session si la connexion est ok.
</WRAP>

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

<WRAP list-deep>
  - **Connectez-vous à votre serveur via SSH** :<cli prompt='$ '>...@...:~ $ ssh user@monsite.fr</cli>
  - **Placez-vous dans le répertoire racine de votre serveur web** :<cli prompt='$ '>...@...:~ $ cd /var/www/html</cli>
  - **Récupérez et décompressez l'archive de Dolibarr** :<cli prompt='$ '>...@...:~ $ wget 'https://sourceforge.net/projects/dolibarr/files/Dolibarr ERP-CRM/12.0.4/dolibarr-12.0.4.zip'
...@...:~ $ unzip dolibarr.zip</cli>
  - **Renommez le répertoire dolibarr-x.y.z** pour obtenir un nom de répertoire indépendant de la version (par exemple, en **dolibarr**) :<cli prompt='$ '>...@...:~ $ mv dolibarr-x.y.z dolibarr</cli>(où x.y.z correspond à la version source)
  - **Gestion des droits** :<cli prompt='$ '>...@...:~ $ sudo chmod -R 2755 /var/www/html/dolibarr/
...@...:~ $ sudo chown -R www-data:www-data /var/www/html/dolibarr/</cli>
  - **Fichier de configuration** : créez, dans le répertoire dolibarr/htdocs/conf, un fichier de configuration vide et attribuez-lui comme propriétaire l'utilisateur du serveur web :<cli prompt='$ '>...@...:~ $ sudo touch /var/www/html/dolibarr/htdocs/conf/conf.php
...@...:~ $ sudo chown www-data:www-data /var/www/html/dolibarr/htdocs/conf/conf.php</cli>
  - **Créez le répertoire /var/www/html/dolibarr/documents**, en dehors du répertoire htdocs, pour les documents de Dolibarr (factures pdf, images, ...), attribuez-lui le propriétaire www-data et réglez ses permissions :<cli prompt='$ '>...@...:~ $ sudo mkdir -p /var/www/html/dolibarr/documents
...@...:~ $ sudo chown www-data:www-data /var/www/html/dolibarr/documents/
...@...:~ $ sudo chmod -R 2755 /var/www/html/dolibarr/documents/</cli>
  - **Installation** :
    - Ouvrez la page [[http://127.0.0.1/dolibarr/htdocs/]]
    - Suivez les instructions de l'installation
    - Créez un fichier install.lock dans le répertoire dédiés aux documents pour verrouiller la procédure d'installation qui ne pourra plus être appelée par erreur (Il faudra le supprimer pour les mises à jour) :<cli prompt='$ '>...@...:~ $ sudo touch /var/www/html/dolibarr/documents/install.lock
...@...:~ $ sudo chmod go-w /var/www/html/dolibarr/documents</cli>
</WRAP>

===== Conclusion =====

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

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

  * **(fr)** [[https://wiki.dolibarr.org/index.php?title=Installation_-_Mise_%C3%A0_jour#Avec_Dolibarr_.28package_standard_.zip_ou_sources_Git.29]]

----
//Basé sur << [[https://wiki.dolibarr.org/index.php?title=Installation_-_Mise_%C3%A0_jour#Avec_Dolibarr_.28package_standard_.zip_ou_sources_Git.29|Installation - Mise à jour]] >> par dolibarr.org.//