Installer Dolibarr sous Linux

La documentation en Français : https://wiki.dolibarr.org/index.php/Accueil 

1. En local, sur un poste de travail

https://wiki.dolibarr.org/index.php?title=Dolibarr_for_Ubuntu_or_Debian

dolibarr screenshot

2. Sur un serveur Debian – VPS, NUC, …

Dolibarr for Ubuntu or Debian (DoliDeb) is a version of Dolibarr ERP/CRM, packaged with Mysql, PHP and Apache or Lighttpd, with an automatic installer for Ubuntu or Debian users that don’t have any technical knowledge.

In a few seconds, after installing this package, you are able to work on Dolibarr, even if you don’t have already a web server or if you don’t know what is Apache/Lighttpd, Mysql or PHP. Everything is installed for you.

Pre-requis : Créer une BD et un User :

root@vps633075# mysql -u root -p

CREATE DATABASE dolibarr CHARACTER SET utf8 COLLATE utf8_unicode_ci;
CREATE USER 'dolibarr'@'localhost' IDENTIFIED BY 'cm…';
GRANT ALL PRIVILEGES ON dolibarr.* TO 'dolibarr'@'localhost';
FLUSH PRIVILEGES;
exit;

Installer Dolibarr

Vérifier la dernière version stable : https://www.dolibarr.org/files/stable

cd /tmp
wget https://www.dolibarr.org/files/stable/package_debian-ubuntu/dolibarr_18.0.3_all.deb
sudo dpkg -i dolibarr_17.0.3-4_all.deb 
sudo apt install -f

Se connecter ensuite à la page d’accueil : http://localhost/dolibarr et suivre les étapes pour compléter le paramétrage :

NB : Notez bien le mot de passe administrateur que vous allez saisir à la fin !!!

dolibarr install 8 saisir pswd admin


Après installation, si vous rencontrez des problèmes avec le module WYSIWYG, ouvrir le fichier /etc/dolibar/conf.php et commentez la ligne :

$dolibarr_js_CKEDITOR=...

3. Sur un serveur Debian en mode services

https://wiki.dolibarr.org/index.php?title=Installation_-Mise%C3%A0_jour

Prérequis

Apache, PHP et un serveur de base de données (MySQL ou PostgreSQL) sont présents et opérationnels, et le login/mot de passe d’accès (à une nouvelle base ou au serveur) est connu.

Niveau : Un peu de connaissances informatiques en administration Web.

Cette procédure décrit l’installation manuelle (recommandée) sur un système GNU/Linux (Debian, Mandriva, …) mais elle est valable avec d’autres systèmes moyennant une adaptation des chemins à ceux de votre OS.

Elle est applicable pour toute version de Dolibarr >= 2.0.0

Pour des instructions spécifiques à une installation sous Windows, vous pouvez consulter la page Installation manuelle sous Windows.

  • Vérifiez que vous avez bien Apache, PHP 5.6.0+ (requires functions like DateTimeZone.getOffset, php-intl) et un serveur de base de données (MySQL 5.1+, MariaDB ou PostgreSQL) d’installés (consulter pour cela la liste des packages installés sur votre machine grâce au gestionnaire de mise à jour de package de votre distribution).
  • Vérifiez que le serveur Web est lancé (systemctl status httpd.service par exemple). L’activer le cas échéant (systemctl enable --now httpd.service)
  • Vérifiez que l’utilisateur root ou admin principal pour le serveur de base de donnée est connu et fonctionne correctement. Si cet utilisateur root ou admin est inconnu car pas encore défini, lisez le chapitre qui suit. Sinon vous pouvez passez au point suivant:
MySql ou MariaDB

Vérifiez que le serveur de base de données est lancé (systemctl status mysqld.service par exemple). L’activer le cas échéant (systemctl enable --now mysql.service).

Pour les utilisateurs Linux utilisant MySql ou MariaDB, si vous venez juste d’installer la base de donnée, le login administrateur est root. Vous devez exécuter la commande suivante pour initialiser le mot de passe: mysql

Une fois dans l’interface Mysql, taper la commande de modification du mot de passe de root: grant all privileges on *.* to root@’localhost’ identified by ‘newrootpass’ with grant option;

Puis entrée et pour quitter \q

Pour vérifier que l’accès avec ce couple user/mot de passe fonctionne, lancer la commande mysql -u root -p

Et taper votre mot de passe newrootpass suivi de \q pour quitter la sessions si la connexion a réussie.

Postgresql

Pour les utilisateurs Linux utilisant 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. Pour cela, ajouter la ligne suivante dans le fichier /etc/postgresql/x.x/main/pg_hba.conf (remplacer x.x avec votre version de postgres) local all dolibarrowner md5

De plus, mettez en commentaire la ligne #local all all ident

qui impose que le compte système utilisé pour accéder à la base (ce sera le compte sous lequel tourne l’application web), ait le même nom que le compte dans la base (ce n’est jamais le cas).

Ensuite, lancer la commande sous un shell root 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

Vous pouvez tester la connexion pour l’utilisateur crée avec la commande 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.

Copie des fichiers
  • Placez-vous dans le répertoire dans lequel installer Dolibarr (le répertoire racine défini pour votre serveur web)
  1. Pour Debian et les familles Ubuntu, il s’agit en général de: /var/www
  2. Pour Mandriva, Mageia, RedHat, Fedora: /var/www/html
  3. Pour Suse: /srv/www/htdocs

$ cd /var/www

  • Récupérez l’application
Avec l’archive

Si vous partez du fichier dolibarr.zip, récupérez le fichier et décompressez l’archive de l’application (ex: version 12.0.4) $ wget ‘https://sourceforge.net/projects/dolibarr/files/Dolibarr ERP-CRM/12.0.4/dolibarr-12.0.4.zip’ $ unzip dolibarr.zip

Renommez le répertoire dolibarr-x.y.z en dolibarr afin d’avoir un nom de répertoire indépendant de la version (où x.y.z correspond à la version source) $ mv dolibarr-x.y.z dolibarr

Avec les sources Git

Si vous partez des sources Git, récupérer les sources par $ git clone -b X.Y http://github.com/Dolibarr/dolibarr.git dolibarr

X.Y est la version à installer(Par exemple 9.0, 11.0, …). Il est possible de remplacer X.Y par develop pour récupérer la version en cours de développement.

Gestion des droits

Modifiez les permissions et propriétaires du répertoire ‘dolibarr’ pour être sur que tous les fichiers soient en lecture pour l’utilisateur sur lequel tourne le serveur (on supposera qu’il s’agit de l’utilisateur ‘www-data’ pour debian ou ubuntu, ‘apache’ pour Redhat, Mandriva, Mageia, Fedora) $ chmod -R 755 /var/www/dolibarr $ chown -R www-data:www-data /var/www/dolibarr ou $ chmod -R 755 /var/www/html/dolibarr $ chown -R apache:apache /var/www/html/dolibarr

Fichier de configuration

En tant que root, créez, dans le répertoire dolibarr/htdocs/conf, un fichier de configuration vide, et attribuez-lui comme propriétaire du fichier, l’utilisateur du serveur web (exemple www-data sur debian, nobody sur une vieille RedHat, apache sur une autre version …). Ceci est requis car le serveur web a besoin d’écrire dans ce fichier lors de l’installation. $ cd dolibarr ; touch htdocs/conf/conf.php ; chown www-data htdocs/conf/conf.php

SELinux sur Fedora

Sur Fedora, comme SELinux est activé en général, il est aussi conseillé de lancer les commandes pour rendre le répertoire ‘dolibarr’ accepté par l’environnement SELinux (an absence de commande, vous devriez recevoir des nombreuses alertes d’anomalies) : $ semanage fcontext -a -t httpd_sys_rw_content_t ‘/var/www/html/dolibarr(/.*)?’ $ restorecon -R -v ‘/var/www/html/dolibarr’

Répertoire de documents

Toujours en root, créez le répertoire qui servira aux documents générés ou stockés par Dolibarr (factures pdf, images, …), et attribuez lui comme propriétaire, l’utilisateur du serveur web (exemple www-data sur Debian, nobody sur une vieille RedHat, apache sur une Mandriva, Mageia ou une RedHat récente, …). Le serveur web doit avoir les droits en écriture dans ce répertoire. Il faut choisir un répertoire en dehors de la racine du site web. Par exemple « /var/lib/dolibarr/documents » $ mkdir -p /var/lib/dolibarr/documents ; chown www-data /var/lib/dolibarr/documents

Installation
  • Pointez votre navigateur sur la page principale

http://127.0.0.1/dolibarr/htdocs/

  • Suivez les instructions de l’installation
  • Pour des raisons de sécurité nous vous conseillons, une fois l’installation terminée, de créer un fichier install.lock dans le répertoire dédiés aux documents, que seul root doit avoir le droit d’effacer. Ceci va verrouiller la procédure d’installation qui ne pourra plus être appelée par erreur (Il faudra le supprimer pour les mises à jour).

$ touch /var/lib/dolibarr/documents/install.lock; chmod go-w /var/lib/dolibarr/documents;