Manual installation on Windows

Return to user
documentation index

This page describes the installation of various components needed to run Dolibarr on a Windows environment.

The installation has been done on Windows 10 but should be functional for earlier versions of Windows - some screenshots just won't fit.

If you are a beginner, please note that the section Installation - Update With DoliWamp (Windows .exe package) also discusses automated installation with DoliWamp.

The interest to install even the different "Server" components needed for Dolibarr to work properly is the possibility to choose newer versions than those proposed by the DoliWamp installer.

It is also an excellent way to understand how it works and to deepen your knowledge about deployment and maintenance of a Dolibarr instance.

This documentation page has been written with the goal to be understandable to the largest number of people (whatever the computer level). Some precisions could appear as trivial for some people but will certainly be useful for others. If you are a (great) beginner, don't try to go fast and take the time to read the different sections of the page carefully (allow a big half-day for implementation).

In the following page, it has been tried as much as possible to explain the different actions you are going to perform (the aim being to understand and not to copy/paste or mechanically apply instructions). In order to easily distinguish the explanations from the actions to be performed, please note that all the actions to be performed are preceded by a bullet (•).

Dolibarr Architecture

Dolibarr is a Web software of type "Client/Server.

So it requires a 'Web Server with scripting language PHP and a Relational Database Management System to work.

Dolibarr Client/Server Architecture

Functioning

On the "Client" side, you use a Internet browser (Firefox, Chrome, Opera, Internet Explorer, etc.) to access the Dolibarr interface by typing the address of the Web Server.

As soon as you type address to which Web Server answers (for example http://localhost/dolibarr), it will try to display main page of sub directory Dolibarr (according to Web Server configuration, main page of a directory - also called index page - can be for example index.html, index.htm or index.php).

Generally, by default, the Web Server will be configured to recognize only index.html files as index files but we will see together how to add index.php files.

The files .php being script files written in the PHP language, they will not be directly understandable by the browser of the "Client" which is only able to display HTML.

So we will have to tell the Web Server that when it encounters a file with the extension .php, it will have to use its module mod_php to interpret (or convert if you prefer) the PHP code into HTML code before sending it back to the "Client" (i.e. the browser).

Finally, we also need to install a Relational Database Management System, here MariaDB to store Dolibarr data (it's Dolibarr PHP scripts that will interact with the RDBMS to write or read data from it).

Installing and configuring MariaDB

First we will install the MariaDB database server.

Download MariaDB

• Go to the MariaDB download site and click on the green button Download xx.x.x.xx Stable now! (normally the second green button on the page).
• In the right column, to filter the available files :
  • Check the box Windows in the Operating System, section.
  • in the Package Type section, tick MSI Package.
  • In the CPU section, check 32-bit or 64-bit depending on your operating system (if you do not know, refer to the Appendix How do I know if my computer runs the 32-bit or 64-bit version of Windows ?).
• Click on the link to download the only file now displayed in the list.

Install MariaDB

• 

  Welcome to the installation wizard, click Next.

• 

  Check the box I accept the terms in the License Agreement to accept the terms of the license agreement then click Next.

• 

  This page allows you to customize the components to be installed. By default, all components are selected to be installed. Click on Next.

• 

  In this step, the installer asks you to choose a password for the database administrator. Choose a strong password that you will remember then enter it in the fields New root password and Confirm. Also check the box Use UTF8 as default server's character set then click Next.

• 

  In this step, the installer proposes to customize the port on which the database server will be available and allows to create a Windows Service allowing the automatic start of the server when the computer is started. Leave all the default choices and click Next. If port 3306 is already in use, read the appendix What are "Listening Ports" and how do I know if a program already occupies a specific port? for more information.

• 

  his page allows you - if you wish - to send anonymous information about your use to the MariaDB designers (choose, then click Next).

• 

  Click Install to start the installation.

• 

  The wizard installs the database server files, creates the associated Windows service and starts it.

• 

  The installation is complete and the MariaDB database server is running. Click Finish to exit the installation wizard.

At this level, MariaDB is now installed and started. As a Windows "Service" has been created, the RDBMS will be automatically started at each (re)startup of the computer.

Installing and Configuring PHP

Download PHP

• Please visit https://windows.php.net/download
• In the list of proposed downloads, take the latest Thread Safe version of PHP corresponding to your architecture (x64 if your system is 64 bits or x86 if your system is 32 bits).
  • This is normally the second proposed download (Warning ! Be careful to download the Thread Safe version and NOT No Thread Safe').
• Once you have found the right version, download the file by clicking on the link Zip.

Extract the archive to install PHP

• Once downloaded, right click on the archive and select Extract all....
• Indicate C:\php as the destination path and click Extract.

Configure PHP

Now that PHP is uncompressed in the right place, we'll configure some settings.

PHP is delivered with extensions and Dolibarr needs that some of these extensions are enabled (they are not enabled by default).

Enable Display of Filename Extensions

• In the Windows File Explorer, click on the View tab and check the File Name Extensions checkbox in the Show/Hide group.

Enable Display of File Name Extensions.