Installation - Upgrade

Return to user
documentation index

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

If this is not done, Dolibarr will show you a warning one logged by an administrator user.

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

Upgrade Dolibarr manually

This chapter describes a manual upgrade process of Dolibarr (from an old existing version) to a more recent one. It works for any Dolibarr version that is >= 2.0.0

• Go into the directory where you installed Dolibarr (it might be the root directory of your web, for example /var/www under Debian)

$ cd /var/www

• Get archive of last version

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

• Uncompress the archive

$ tar xvfz dolibarr.tgz

• Copy all new extracted files (the one uncompressed into directory dolibarr-x.y.z) to the directory where you put your old Dolibarr version. This will overwrite old files with new ones without removing files specifics to your installation (like conf.php file or complementary non official installed modules).

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

• If no error, you can now remove the directory of source files

$ rm -fr dolibarr-x.y.z

• Now call the install/ page of Dolibarr in your browser

http://127.0.0.1/dolibarr/install/

If you have a message that tell the install process is locked by a file, remove the file install.lock stored in Dolibarr root directory.

• Choose Update in proposed menu

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

If this is not done, Dolibarr will show you a warning one logged by an administrator user.

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

Setup a LDAP connexion

To complete.

Import external data

For this operation, read page Mass imports.