Installation - Upgrade

Return to user
documentation index

Page waiting for translation. To translate, create an account, go back and clic on "Modify". Page en attente de traduction. Pour traduire, créez un compte, revenez et cliquez sur "Modifier". Página a traducir. Para traducirla, cree una cuenta, vuelva a la página y haga clic en "editar". Pagina da tradurre. Per tradurla, crea un utente, torna indietro e clicca su "modifica". Página a aguardar por tradução. Para traduzir, crie uma conta, volte atrás e clique em "Modificar". Seite wartet auf Übersetzung. Um Übersetzung zu erstellen, richte einen Account ein, geh zurück und klicke auf "bearbeiten". 页面等待翻译。若要翻译本页，先创建一个帐户、登录并返回本页后单击“编辑”。

The following documentation describes processes to install or upgrade Dolibarr on a Unix like platform without using any particular packages provided by your Linux distribution.

If you're looking for an operating mode for Windows, this documentation can be adapted. However, there is also a specialized Dolibarr distribution for Windows called DoliWamp. This one allows you to make an installation under Windows with all prerequisites (Apache, Mysql, PHP) and with no computer knowledge (See page download DoliWamp on NLTechno web site).

If you are under Linux and have already an Apache, Mysql and operational PHP, following chapters will presents how to install and upgrade a Dolibarr version.

Setup to install manually

Prerequisite: Apache, Mysql and PHP are already running correctly.

This procedure describe manual (and recommended) installation on a GNU/Linux system (Debian, Mandriva, ...), it can be used for other OS if minor changes. You can follow this help for any Dolibarr version >= 2.0.0

• Check that you have installed Apache, Mysql and PHP correctly (check list of installed packged on your server by using the package manager of your distribution). If not install them (use last recent version).

• Go into the directory where to install Dolibarr (the web root directory defined for your web server)

$ cd /var/www

1. For Debian and Ubuntu families, it is generally: /var/www
2. For Mandriva: /var/www/html
3. For RedHat: to complete
4. For Suse: to complete

• Get the application archive of last stable version

$ wget http://www.dolibarr.org/files/dolibarr.tgz

• Uncompress archive

$ tar xvfz dolibarr.tgz

• Rename directory dolibarr-x.y.z into dolibarr to have a directory name that does not depends on version (replace x.y.z with source version)

$ mv dolibarr-x.y.z dolibarr

• 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

• 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 ou une RedHat récente, ...). Le serveur web doit avoir les droits en écriture dans ce répertoire.

$ mkdir documents ; chown www-data documents

• 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'installation, que seul root doit avoir le droit d'effacer.

$ touch /var/www/dolibarr/install.lock; chmod ug-w /var/www/dolibarr;

Procédure de mise à jour manuelle

Cette procédure décrit la mise à jour manuelle de Dolibarr (depuis une ancienne version) vers une plus récente. Elle est applicable dès lors que la mise à jour se fait pour une version de Dolibarr >= 2.0.0

• Placez-vous dans le répertoire dans lequel a été installé Dolibarr (le répertoire racine de votre serveur web, par exemple /var/www sous Debian)

$ cd /var/www

• Récupérez l'archive de la nouvelle version

$ wget http://www.nltechno.com/files/dolibarr.tgz

• Décompressez l'archive

$ tar xvfz dolibarr.tgz

• Recopiez les nouveaux fichiers (qui ont été décompressés dans le répertoire dolibarr-x.y.z) vers le répertoire où vous avez votre ancienne version de Dolibarr

$ cp -r dolibarr-x.y.z/* dolibarr

• Vous pouvez alors supprimer le répertoire des fichiers sources

$ rm -fr dolibarr-x.y.z

• Pointez votre navigateur sur la page d'install

http://127.0.0.1/dolibarr/install/

• Choisissez Mise à jour dans le menu proposé

• Pour des raisons de sécurité nous vous conseillons, une fois la mise à jour terminée, de verrouiller le répertoire d'installation. Dans le cas contraire, Dolibarr vous avertira d'un message dans l'interface une fois loggé

$ echo > dolibarr/install.lock
$ chmod 444 dolibarr/install.lock

Configurer une connexion LDAP

A compléter.

Importer des données externes

Pour cette opération, consulter la page Imports_de_masse.