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

• As a root user, create, into directory dolibarr/htdocs/conf, an empty configuration file called conf.php and set, as owner, the web server user (example www-data on Debian, nobody on old RedHat, apache on Mandriva, recent RedHat or other distributions ...). This is required because the web server will have to write into this file during install process.

$ cd dolibarr ; touch htdocs/conf/conf.php ; chown www-data htdocs/conf/conf.php

• Always as a root user, create a directory that will serve to save all generated and stocked by Dolibarr (PDf invoices, uploaded images, ...), and attribute to this directory a owner that must be the web server (example www-data on Debian, nobody on old RedHat, apache on Mandriva or recent RedHat, ...). The web server must have write permission into this directory.

$ mkdir documents ; chown www-data documents

• Now call your browser to point to the main page

http://127.0.0.1/dolibarr/htdocs/

• Follow instructions of setup steps until end of install process.

• For security reason, we recommend, once setup is finished, to create a file install.lock into Dolibarr installed directory that only root user can delete. This will lock the call of the install process again (you will have to remove it for upgrades)

$ 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

Setup a LDAP connexion

To complete.

Importer des données externes

Pour cette opération, consulter la page Imports_de_masse.