Installer Dolibarr sur un serveur local

1. utilisateur root ou admin principal pour le serveur de base de donnée connu et fonctionnel

USER@MACHINE:~$ scp dolibarr-x.y.z.zip user@monsite.fr:/var/www/html/

1. connectez-vous à votre serveur,
2. placez-vous dans son répertoire racine
3. décompressez l'archive de Dolibarr
4. Renommez le répertoire dolibarr-x.y.z pour obtenir un nom de répertoire indépendant de la version (par exemple, dolibarr) :

   USER@MACHINE:~$ ssh user@monsite.fr
   user@monsite.fr:~ $ cd /var/www/html
   user@monsite.fr:/var/www/html $ unzip dolibarr-x.y.z.zip
   user@monsite.fr:/var/www/html $ mv dolibarr-x.y.z dolibarr

5. Gestion des droits :

   user@monsite.fr:/var/www/html $ sudo chmod -R 2755 /var/www/html/dolibarr/
   user@monsite.fr:/var/www/html $ sudo chown -R www-data:www-data /var/www/html/dolibarr/

1. créez un fichier de configuration vide dans le répertoire dolibarr/htdocs/conf
2. attribuez-lui e propriétaire www-data :

   user@monsite.fr:/var/www/html $ sudo touch /var/www/html/dolibarr/htdocs/conf/conf.php
   user@monsite.fr:/var/www/html $ sudo chown www-data:www-data /var/www/html/dolibarr/htdocs/conf/conf.php

1. Créez le répertoire /var/www/html/dolibarr/documents, en dehors du répertoire htdocs, pour les documents de Dolibarr (factures pdf, images, …)
2. attribuez-lui le propriétaire www-data
3. et réglez ses permissions :

   user@monsite.fr:/var/www/html $ sudo mkdir -p /var/www/html/dolibarr/documents
   user@monsite.fr:/var/www/html $ sudo chown www-data:www-data /var/www/html/dolibarr/documents/
   user@monsite.fr:/var/www/html $ sudo chmod -R 2755 /var/www/html/dolibarr/documents/

1. avec nginx :

   /etc/nginx/sites-available/mondomaine.tld

   # sous-domaines dolibarr
   server {
       listen 80;
       
       server_name  ~^(?P<sub>dolibarr)\.mondomaine\.tld$;
       root /var/www/html/$sub/htdocs;
       
   	location / {
   		index index.php index.html index.htm;
   		try_files $uri $uri/ =404;
   	}
   
   	location ~ \.php$ {
   		include snippets/fastcgi-php.conf;
   		fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
   	}
   
   	location ~ /\.ht {
   			deny all;
   	}
   }

2. avec Apache2 : à faire

1. Pour initialiser le mot de passe, lancez mysql pour modifier le mot de passe de root (Donnez le mot de passe, \q pour quitter) :

   USER@MACHINE:~$ mysql -u root -p
   Enter password: 
   ...
   MariaDB [(none)]> grant all privileges on *.* to root@'localhost' identified by 'newrootpass' with grant option;
   MariaDB [(none)]> \q
   Bye

2. Pour vérifier :

   USER@MACHINE:~$ mysql -u root -p
   Enter password: 
   ...
   MariaDB [(none)]> \q
   Bye

   Tapez votre nouveau mot de passe et \q pour quitter la session.

1. 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 :

   1. Ajoutez la ligne suivante dans le fichier /etc/postgresql/x.x/main/pg_hba.conf (remplacer x.x avec votre version de postgres) :

      /etc/postgresql/x.x/main/pg_hba.conf

      local   all         dolibarrowner    md5

   2. Mettez en commentaire la ligne

      /etc/postgresql/x.x/main/pg_hba.conf

      #local   all         all                               ident

      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).

2. Puis lancez la commande :

   USER@MACHINE:~$ 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

3. Testez la connexion pour l'utilisateur créé :

   USER@MACHINE:~$ psql -h localhost -d postgres -U dolibarrowner -W

   et entrez le mot de passe dolibarrownerpass et \q pour quitter la session si la connexion est ok.

1. Base de données Dolibarr

   1. Nom de la base de données : Donnez le nom de votre base de données (ex : xxxxx-gestion)
   2. Créer la base de données : Cochez cette option si la base de données n'existe pas et doit être créée. Dans ce cas, il faut renseigner identifiant et mot de passe du super-utilisateur au bas de cette page.
   3. Identifiant : Identifiant du propriétaire de la base de données Dolibarr.
   4. Mot de passe : Mot de passe du propriétaire de la base de données Dolibarr.
   5. Créer le propriétaire : Cochez cette option si l'utilisateur propriétaire n'existe pas et doit être créé. Dans ce cas, il faut renseigner l'identifiant et mot de passe du propriétaire à créer ainsi que l'identifiant et mot de passe du super-utilisateur au bas de cette page. Si la case n'est pas cochée, l'identifiant et le mot de passe du propriétaire doivent exister.
2. Serveur de base de données - Accès super utilisateur

   1. Identifiant : Identifiant de l'utilisateur de la base ayant les droits de création de bases de données ou de comptes pour la base, requis si la base ou son propriétaire n'existent pas déjà et doivent être créés.
   2. Mot de passe Laissez vide si l'administrateur n'a pas de mot de passe
3. Pour le reste, vous pouvez garder les valeurs proposées (vérifiez tout de même)
4. Cliquez sur Étape suivante

user@monsite.fr:/var/www/html $ sudo touch /var/www/html/dolibarr/documents/install.lock
user@monsite.fr:/var/www/html $ sudo chmod go-w /var/www/html/dolibarr/documents