{{tag>tutoriel}} ====== Installer Dolibarr sur un serveur local ====== Vidéo : Dolibarr en local : Pourquoi et Comment l'installer sur votre ordinateur grâce à Wampserver (2020) :\\ {{ youtube>FeyOIV4cqN4 }} ===== 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 : Téléchargement et mise en place ===== - **Téléchargez la dernière version de Dolibarr sur [[https://sourceforge.net/projects/dolibarr/files/latest/download]]** -> fichier **dolibarr-x.y.z.zip** ((où x.y.z correspond à la version source)) - **Envoyez, via SCP**, cette archive à la racine du serveur :USER@MACHINE:~$ scp dolibarr-x.y.z.zip user@monsite.fr:/var/www/html/ - **Via SSH**, - **connectez-vous à votre serveur**, - **placez-vous dans son répertoire racine** - **décompressez l'archive** de Dolibarr - **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 - **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/ - **Fichier de configuration** : - **créez un fichier de configuration vide** dans le répertoire dolibarr/htdocs/conf - **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 - **Répertoire pour les documents** : - **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** :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/ - **[[tutoriel:reseau:crm:dolibarr:install:ovh:start]]** ===== Autres étapes ===== ==== Configuration du serveur Web ==== - **Configurez votre serveur Web pour utiliser dolibarr/htdocs comme racine** par exemple en créant un hôte virtuel : - avec **nginx** :# sous-domaines dolibarr server { listen 80; server_name ~^(?Pdolibarr)\.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; } } - avec **Apache2** :FIXME à faire ==== Sécurisation de la base de données ==== - **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) :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 - **Pour vérifier** :USER@MACHINE:~$ mysql -u root -p Enter password: ... MariaDB [(none)]> \q ByeTapez 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) :local all dolibarrowner md5 - Mettez en commentaire la ligne#local all all identqui 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 :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 - Testez la connexion pour l'utilisateur créé :USER@MACHINE:~$ psql -h localhost -d postgres -U dolibarrowner -Wet entrez le mot de passe dolibarrownerpass et \q pour quitter la session si la connexion est ok. ==== Lancement de l'installation ==== - **Ouvrez le site**, par exemple à [[http://127.0.0.1/dolibarr/htdocs]]. L'installation démarre - Choisissez la **langue** puis Étape suivante - Si tout s'est bien passé, cliquez sur le bouton Démarrer - **Renseignez** : - **Base de données Dolibarr** - **Nom de la base de données** : Donnez le nom de votre base de données (ex : xxxxx-gestion) - **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. - **Identifiant** : Identifiant du propriétaire de la base de données Dolibarr. - **Mot de passe** : Mot de passe du propriétaire de la base de données Dolibarr. - **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. - **Serveur de base de données - Accès super utilisateur** - **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. - **Mot de passe** Laissez vide si l'administrateur n'a pas de mot de passe - Pour le reste, vous pouvez garder les valeurs proposées (vérifiez tout de même) - **Cliquez sur Étape suivante** - **Vérifiez** que tout s'est bien passé puis Étape suivante (En cas de time out, rechargez la page) - **Si tout s'est bien passé**, Étape suivante - **Dernière étape** : Définissez l'identifiant et le mot de passe du premier utilisateur que vous allez utiliser pour vous connecter à l'application.Ne perdez pas ces identifiants, il s'agit du compte permettant d'administrer les autres. - Si tout s'est bien passé, cliquez sur le lien __Accéder à Dolibarr (espace de configuration)__ pour configurer Dolibarr selon vos besoins. - 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) :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 ===== Conclusion ===== ===== Problèmes connus ===== ===== Voir aussi ===== * **(fr)** [[https://wiki.dolibarr.org/index.php?title=Documentation_utilisateur]] ---- //Basé sur << [[https://wiki.dolibarr.org/index.php?title=Documentation_utilisateur|Documentation]] >> par dolibarr.//