4
edits
Changes
m
texte modifi non affichéé correctement
Line 15:
Line 15:
−
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
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.
+The interest to install by yourself 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.
It is also an excellent way to understand how it works and to deepen your knowledge about deployment and maintenance of a Dolibarr instance.
Line 45:
Line 45:
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 <abbr title="Relational Database Management System">RDBMS</abbr> to write or read data from it).
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 <abbr title="Relational Database Management System">RDBMS</abbr> to write or read data from it).
−=Installing and configuring MariaDB=
+==Installing and configuring MariaDB==
First we will install the MariaDB database server.
First we will install the MariaDB database server.
−==Download MariaDB==
+===Download MariaDB===
*Go to [https://downloads.mariadb.org/ 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).
*Go to [https://downloads.mariadb.org/ 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).
Line 54:
Line 54:
**Check the box '''Windows''' in the '''Operating System,''' section.
**Check the box '''Windows''' in the '''Operating System,''' section.
**in the '''Package Type''' section, tick '''MSI Package'''.
**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 [[Draft:Manual installation on Windows#How do I know if my computer runs the 32-bit or 64-bit version of Windows ?|How do I know if my computer runs the 32-bit or 64-bit version of Windows ?]]).
+**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_is_running_32-bit_or_64-bit_version_of_Windows.3F|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.
*Click on the link to download the only file now displayed in the list.
−==Install MariaDB==
+===Install MariaDB===
<gallery widths="495" heights="387">
<gallery widths="495" heights="387">
File:MariaDB Install 1.png|Welcome to the installation wizard, click '''Next'''.
File:MariaDB Install 1.png|Welcome to the installation wizard, click '''Next'''.
Line 63:
Line 63:
File:MariaDB Install 3.png|This page allows you to customize the components to be installed. By default, all components are selected to be installed. Click on '''Next'''.
File:MariaDB Install 3.png|This page allows you to customize the components to be installed. By default, all components are selected to be installed. Click on '''Next'''.
File:MariaDB Install 4.png|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'''.
File:MariaDB Install 4.png|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'''.
−File:MariaDB Install 5.png|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 [[Manual installation on Windows#What are "Listening Ports" and how do I know if a program already occupies a specific port? |What are "Listening Ports" and how do I know if a program already occupies a specific port?]] for more information.
+File:MariaDB Install 5.png|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 [[Manual_installation_on_Windows#What are "Listening Ports" and how do I know if a program already occupies a specific port? |What are "Listening Ports" and how do I know if a program already occupies a specific port?]] for more information.
File:MariaDB Install 6.png|his page allows you - if you wish - to send anonymous information about your use to the MariaDB designers (choose, then click '''Next''').
File:MariaDB Install 6.png|his page allows you - if you wish - to send anonymous information about your use to the MariaDB designers (choose, then click '''Next''').
File:MariaDB Install 7.png|Click '''Install''' to start the installation.
File:MariaDB Install 7.png|Click '''Install''' to start the installation.
Line 77:
Line 77:
*Please visit https://windows.php.net/download
*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).
*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 ('''<u>Warning !</u> Be careful to download the ''Thread Safe'' version and NOT ''<u>No</u> Thread Safe'''''').
+**This is normally the second proposed download ('''<u>Warning !</u> Be careful to download the ''Thread Safe'' version and NOT ''<u>No</u> Thread Safe'<nowiki/>''''').
*Once you have found the right version, download the file by clicking on the link '''<u>Zip</u>'''.
*Once you have found the right version, download the file by clicking on the link '''<u>Zip</u>'''.
Line 83:
Line 83:
===Extract the archive to install PHP===
===Extract the archive to install PHP===
+
*Once downloaded, right click on the archive and select '''Extract all...'''.
*Once downloaded, right click on the archive and select '''Extract all...'''.
*Indicate <code>C:\php</code> as the destination path and click '''Extract'''.
*Indicate <code>C:\php</code> as the destination path and click '''Extract'''.
Line 97:
Line 98:
====Enable Display of Filename Extensions====
====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.
*In the Windows '''File Explorer''', click on the '''View''' tab and check the '''File Name Extensions''' checkbox in the '''Show/Hide''' group.
Line 126:
Line 128:
</syntaxhighlight>In this section, you will need to remove the <code>;</code> in front of some of the extensions to load them (change for example <code>;extension=gd2</code> to <code>extension=gd2</code>).
</syntaxhighlight>In this section, you will need to remove the <code>;</code> in front of some of the extensions to load them (change for example <code>;extension=gd2</code> to <code>extension=gd2</code>).
−Remove the <code>;</code> in front of the lines <code>;extension=curl</code>, <code>;extension=gd2</code>, <code>;extension=intl</code>, <code>;extension=mysqli</code>.
+Remove the <code>;</code> in front of the lines <code>;extension=curl</code>, <code>;extension=gd2</code>, <code>;extension=intl</code>, <code>;extension=mysqli</code>, <code>;extension=mbstring</code>, <code>;extension=imap</code>.
<br />
<br />
Line 161:
Line 163:
*Go to https://www.apachelounge.com/download/
*Go to https://www.apachelounge.com/download/
*Download the file corresponding to the architecture of your operating system by clicking on the link (Win64 for 64 bits or Win32 for 32 bits).
*Download the file corresponding to the architecture of your operating system by clicking on the link (Win64 for 64 bits or Win32 for 32 bits).
+
<br />
<br />
Line 189:
Line 192:
====Treat the files <code>index.php</code> as index files====
====Treat the files <code>index.php</code> as index files====
−* Look for the block
+*Look for the block
+<syntaxhighlight lang="apacheconf">
<syntaxhighlight lang="apacheconf">
<IfModule dir_module>
<IfModule dir_module>
Line 205:
Line 209:
*At the very end of the file <code>httpd.conf</code>, skip a line and paste the following block of code to tell '''Apache2''' to interpret the files <code>*.php</code> :
*At the very end of the file <code>httpd.conf</code>, skip a line and paste the following block of code to tell '''Apache2''' to interpret the files <code>*.php</code> :
+
+*Before PHP 8.0:
+
<syntaxhighlight lang="apacheconf">
<syntaxhighlight lang="apacheconf">
LoadModule php7_module "c:/php/php7apache2_4.dll"
LoadModule php7_module "c:/php/php7apache2_4.dll"
Line 211:
Line 218:
</syntaxhighlight>
</syntaxhighlight>
−*This will tell '''Apache2''' to use the <code>php7_module</code> provided with PHP that we installed earlier to interpret the <code>*.php</code> files.
+*[https://www.php.net/manual/en/install.windows.apache2.php From PHP 8.0:]
+<syntaxhighlight lang="apacheconf">
+LoadModule php_module "c:/php/php8apache2_4.dll"
+<FilesMatch \.php$>
+ SetHandler application/x-httpd-php
+</FilesMatch>
+PHPIniDir "C:/php"
+</syntaxhighlight>
+*This will tell '''Apache2''' to use the <code>phpX_module</code> provided with PHP that we installed earlier to interpret the <code>*.php</code> files.
*Save the file <code>httpd.conf</code> ('''File''' > '''Save''' or <kbd>Ctrl</kbd> + <kbd>S</kbd>) and close it.
*Save the file <code>httpd.conf</code> ('''File''' > '''Save''' or <kbd>Ctrl</kbd> + <kbd>S</kbd>) and close it.
Line 228:
Line 245:
*With the '''File Explorer''' Windows, go to the '''Local Disk (C:)''' then in the directory '''Apache24''' and then in the sub directory '''bin''' (<code>C:\Apache24\bin</code>).
*With the '''File Explorer''' Windows, go to the '''Local Disk (C:)''' then in the directory '''Apache24''' and then in the sub directory '''bin''' (<code>C:\Apache24\bin</code>).
*Paste the files (right click, then '''Copy''' or Ctrl + V).
*Paste the files (right click, then '''Copy''' or Ctrl + V).
+
<br />
<br />
Line 237:
Line 255:
We will therefore create a Windows "Service" to automatically start '''Apache2''' when the computer is (re)started.
We will therefore create a Windows "Service" to automatically start '''Apache2''' when the computer is (re)started.
−* Next to the Windows button that opens the start menu, in the search box "'''Type here to search'''", click then type <code>cmd</code>. In the list of proposed options, choose '''Run as administrator''' then validate the '''User Account Control''' window.
+*Next to the Windows button that opens the start menu, in the search box "'''Type here to search'''", click then type <code>cmd</code>. In the list of proposed options, choose '''Run as administrator''' then validate the '''User Account Control''' window.
[[File:Exécuter Invite de commandes en tant qu'administrateur.png|none|Execute '''Command Prompt''' Windows as administrator|thumb|613x613px|link=Special:FilePath/Exécuter_Invite_de_commandes_en_tant_qu'administrateur.png]]
[[File:Exécuter Invite de commandes en tant qu'administrateur.png|none|Execute '''Command Prompt''' Windows as administrator|thumb|613x613px|link=Special:FilePath/Exécuter_Invite_de_commandes_en_tant_qu'administrateur.png]]
*Enter the following command in the Windows '''Command Prompt''' and validate with the Enter key :
*Enter the following command in the Windows '''Command Prompt''' and validate with the Enter key :
+
<syntaxhighlight lang="batch">
<syntaxhighlight lang="batch">
C:/Apache24/bin/httpd.exe -k install
C:/Apache24/bin/httpd.exe -k install
Line 250:
Line 269:
*Enter the following command in the Windows '''Command Prompt''' and validate with the Enter key :
*Enter the following command in the Windows '''Command Prompt''' and validate with the Enter key :
+
<syntaxhighlight lang="batch">
<syntaxhighlight lang="batch">
net start Apache2.4
net start Apache2.4
Line 263:
Line 283:
This command tests the validity of your <code>httpd.conf</code> file and should return the line where the error is encountered.
This command tests the validity of your <code>httpd.conf</code> file and should return the line where the error is encountered.
−In addition to common syntax errors due to carelessness, one of the most common errors is the absence of the file <code>C:\php\php7apache2_4.dll</code>. This file is indeed missing if you have downloaded the wrong version of PHP ('''<u>No</u>''' '''Thread Safe''') instead of the '''Thread Safe''' version. In this case, download the good archive ('''Thread Safe''') and perform the [[Manual_Installation_On_Windows#Extract_the_archive_for_PHP_installation]] part again.
+In addition to common syntax errors due to carelessness, one of the most common errors is the absence of the file <code>C:\php\php7apache2_4.dll</code>. This file is indeed missing if you have downloaded the wrong version of PHP ('''<u>No</u>''' '''Thread Safe''') instead of the '''Thread Safe''' version. In this case, download the good archive ('''Thread Safe''') and perform the [[#Extract_the_archive_to_install_PHP]] part again.
−Another problem that can be encountered is the impossibility to start '''Apache2''' because the port '''80''' is already used by another program. See the appendix [[Manual_Installation_On_Windows#What are "Listening Ports" and how to know if a program already occupies a specific port? |What are "Listening Ports" and how to know if a program already occupies a specific port?]] for instructions on how to proceed.
+Another problem that can be encountered is the impossibility to start '''Apache2''' because the port '''80''' is already used by another program. See the appendix [[#What_are_.22Listening_Ports.22_and_how_do_I_know_if_a_program_already_occupies_a_specific_port.3F|What are "Listening Ports" and how to know if a program already occupies a specific port?]] for instructions on how to proceed.
Once you have corrected any errors, try again to start the '''Apache2.4''' Service with the command mentioned above.
Once you have corrected any errors, try again to start the '''Apache2.4''' Service with the command mentioned above.
Line 297:
Line 317:
You can now close the software '''MySQL Client (MariaDB 10.4 (x64)'''.
You can now close the software '''MySQL Client (MariaDB 10.4 (x64)'''.
−===Check if Apache2 works properly====
+===Check if Apache2 works properly===
*Start your favorite Web Browser (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) and enter the address <code>http://localhost</code> in the address bar then validate with '''Enter'''.
*Start your favorite Web Browser (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) and enter the address <code>http://localhost</code> in the address bar then validate with '''Enter'''.
Line 311:
Line 331:
<br />
<br />
−===Check if PHP works properly==
+===Check if PHP works properly===
Concerning the PHP part, we have two things to check.
Concerning the PHP part, we have two things to check.
Line 337:
Line 357:
*Start your favorite Web Browser (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) and this time enter the address <code>http://localhost/test</code> in the address bar then validate with '''Enter'''.
*Start your favorite Web Browser (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) and this time enter the address <code>http://localhost/test</code> in the address bar then validate with '''Enter'''.
−'''Apache2''' should return a page generated by '''PHP''' containing all the configuration information. If you scroll this page, you '''<u>should</u>''' see sections related to the extensions we loaded previously (including <code>curl</code>, <code>gd2</code>, <code>intl</code> and <code>mysqli</code>). If one of these sections is not displayed, it means that the extension is not loaded (so you forgot to remove a semicolon in front of an extension name when editing the <code>C:\php\php.ini</code> or you forgot to copy one of the files mentioned in [[Manual installation On Windows#Copy the files needed for the PHP extensions intl and curl to the bin/ directory of Apache2|Copy the files needed for the PHP extensions <code>intl</code> and <code>curl</code> to the <code>bin/</code> directory of Apache2]]. Check and correct if necessary your omissions and then restart the Service '''Apache2.4''' so that your changes are taken into account (see appendix [[Manual installation on Windows#How to manage Windows "Services" ?|How to manage Windows "Services" ?]] to know how to restart an existing Service).
+'''Apache2''' should return a page generated by '''PHP''' containing all the configuration information. If you scroll this page, you '''<u>should</u>''' see sections related to the extensions we loaded previously (including <code>curl</code>, <code>gd2</code>, <code>intl</code> and <code>mysqli</code>). If one of these sections is not displayed, it means that the extension is not loaded (so you forgot to remove a semicolon in front of an extension name when editing the <code>C:\php\php.ini</code> or you forgot to copy one of the files mentioned in [[Manual_installation_on_Windows#Copy the files needed for the PHP extensions intl and curl to the bin/ directory of Apache2|Copy the files needed for the PHP extensions <code>intl</code> and <code>curl</code> to the <code>bin/</code> directory of Apache2]]. Check and correct if necessary your omissions and then restart the Service '''Apache2.4''' so that your changes are taken into account (see appendix [[Manual_installation_on_Windows#How to manage Windows "Services" ?|How to manage Windows "Services" ?]] to know how to restart an existing Service).
[[File:Phpinfo().png|border|none|thumb|750x750px|''Apache2'' returns the page with the configuration information generated by ''PHP''.]
[[File:Phpinfo().png|border|none|thumb|750x750px|''Apache2'' returns the page with the configuration information generated by ''PHP''.]
Line 352:
Line 372:
<br />
<br />
−*
+==Dolibarr installation==
+It's party time (get out the balloons and cotillions), the moment you've been waiting for so long has finally arrived! We will finally be able to install Dolibarr.
+===Download Dolibarr===
+*Please visit the SourceForge mirrors at https://sourceforge.net/projects/dolibarr/files/.
+*Click on the folder '''Dolibarr ERP-CRM''', then on the last version number and click on the file with extension '''.zip''' to download it.
+===Create folder <code>documents</code> of Dolibarr===
+Dolibarr needs a folder <code>documents</code> in which it stores generated documents (Sales proposals, Orders, Invoices, Intervention sheets, Delivery notes) but also documents uploaded by user (Account statements, Supplier invoices, etc.).
+For security reasons, it is preferable to create the folder <code>documents</code> outside the Web Server (for us '''Apache2''').
+*With the Windows'''File Explorer''', go to the '''Local Disk (C:)'''.
+*Create a new folder <code>dolibarr</code> then double click on it and create again a folder <code>documents</code>. So we get the directory <code>C:\dolibarr\documents</code>
+===Extract Dolibarr archive===
+To extract Dolibarr archive, we will proceed in a similar way as '''Apache2''' using drag and drop technique.
+*With Windows File Explorer, go in '''Local disk (C:)''' then in directory '''Apache24'''. Finally, go to the '''htdocs''' directory (<code>C:\Apache24\htdocs</code>).
+*Create the folder <code>dolibarr</code> then double click on it.
+*Double-click then on the Dolibarr archive you just downloaded to open it in a new window of the Windows '''File explorer'''.
+*Browse in the archive to folder <code>dolibarr-xx-x-x</code> then to folder <code>htdocs</code>.
+*Select all the files in the folder <code>htdocs</code> by using the '''Select all''' button of the '''Select''' group of the '''Home''' tab of the '''Windows File Explorer''' (or by using the keyboard shortcut Ctrl + A).
+*Drag the selected files to the folder <code>dolibarr</code> created previously (in the other window).
+[[File:Extraire l'archive Dolibarr dans Apache2.png|none|thumb|773x773px|Extract htdocs directory of Dolibarr archive in the <code>dolibarr</code> directory of Apache2 Web Server.]]
+Because of the large number of files provided with Dolibarr and depending on the speed of your hard drive or SSD, decompression can take several minutes.
+[[File:Décompression archive Dolibarr.png|none|frame|Decompression of Dolibarr archive to directory <code>dolibarr</code> of Apache2 Web Server.|link=Special:FilePath/Décompression_archive_Dolibarr.png]]
+<br />
+===Install Dolibarr===
+*Start your favorite Web browser (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) and enter the address <code>http://localhost/dolibarr</code> in the address bar then validate by '''Enter''' to start Dolibarr installation.
+<gallery widths="500" heights="375">
+File:Installation Dolibarr - Choix de la langue.png|This page allows you to change language (default language selected by default is automatically deduced from your browser language). Click on '''Next step ->'''.
+File:Installation Dolibarr - Vérification des prérequis.png|This page checks prerequisites to install Dolibarr (including different PHP extensions needed). If you followed correctly information of this page, all checks should be validated. Click on '''Start''' button to continue installation.
+File:Installation Dolibarr - Serveur Web.png|This page of installation allows you to define paths. Default values are correct except for '''Directory to contain generated documents (PDF, etc.)'''. Modify this value to indicate the directory we created previously (for reminder <code>C:/dolibarr/documents</code>).
+File:Installation Dolibarr - Base de données.png|On this same page, we will now fill information allowing installer to create Dolibarr database. Refer to section "Configure database" under the gallery for more information.
+File:Installation Dolibarr - Création du fichier de configuration.png|Installer create configuration file containing all information you filled so far and save it on disk in <code>C:\Apache24\htdocs\dolibarr\conf\conf.php</code>. It also creates the user '''dolibarr''' in MariaDB and the database '''dolibarr'''. Click on '''Next step ->'''.
+File:Installation Dolibarr - Création des tables.png|The installer now create all tables in the '''dolibarr''' database (this step can take several seconds, it's normal; be patient).
+File:Installation Dolibarr - Validation de la création des tables.png|This page confirms the good installation of tables, functions and reference data in the '''dolibarr''' database. You can also choose to indicate that you just successfully installed Dolibarr to Dolibarr Association (thank you!). Click on '''Next step ->'''.
+File:Installation Dolibarr - Création de l'administrateur.png|This last step allows you to create the Dolibarr user that will be used to identify you to access Dolibarr. Choose, again, a password different from previous ones (you should never reuse a password anyway) as well as your login. Click on '''Next step ->'''.
+File:Installation Dolibarr - Fin de l'installation.png|It's finished ! Congratulations, you can click on '''Access Dolibarr (configuration space)''' to finish installation. Installer also recommends you to create a file <code>install.lock</code> (we will see how to proceed below).
+</gallery>
+====Configure the database====
+To make the explanations simpler, I have numbered the different fields you need to modify.
+<gallery widths="436" heights="259">
+File:Créer base de données.png
+File:Super-utilisateur base de données.png
+</gallery>
+0 - Check the box '''Create the database'''.
+1 - Fill '''<code>dolibarr</code>''' as identifier (this user will be created in MariaDB by Dolibarr installer and will have '''<u>only</u>''' the authorization to access the newly created '''<code>dolibarr</code>''' database).
+2 - Fill in a different password (that you have never used, and will be specific to the MariaDB user '''<code>dolibarr</code>''')
+3 - Check '''Create owner or assign him rights to the database''' (this asks Dolibarr installer to create new MariaDB user named '''<code>dolibarr</code>''' that we filled if above with specified password).
+4 - Enter '''<code>root</code>''' (this is the MariaDB user id of the database administrator with all rights).
+5 - Enter the MariaDB password of the database administrator that you chose when you installed MariaDB (screen 4 of the installation).
+<br />
+====Terminate Dolibarr configuration====
+<gallery widths="500" heights="340">
+File:S'identifier.png|The Dolibarr login page.
+File:Configuration Dolibarr post-installation.png|The Dolibarr '''Configuration''' page.
+</gallery>
+Now that Dolibarr is successfully installed, we must finish initial setup (it is about filling your company information and activating one or more modules to use).
+*Fill your username and password and click '''Login'''.
+You are automatically redirected to page '''Configuration''' of Dolibarr because initial setup is not finished.
+*In left menu, under '''Configuration''', click on '''Company/Organization''' and fill information about your company then click on '''Save''' at the bottom of page.
+*Always in the left menu, then click on '''Modules/Applications''' and activate the desired modules by clicking on the icon representing a switch at the end of the line.
+<gallery widths="550" heights="340">
+File:Informations société.png|The '''Company/Organisation''' page allows you to fill in the information of your company or organisation.
+File:Activation module.png|The '''Modules/Applications''' page allows you to activate and deactivate the modules you want to use according to your needs.
+</gallery>
+We have now finished initial configuration of Dolibarr. Bravo !
+*Click on '''My dashboard''' to display Dolibarr startup page.
+[[File:Avertissement tableau de bord.png|none|thumb|708x708px|The page '''My dashboard''' of Dolibarr. It currently presents warnings because we didn't create a file <code>install.lock</code> and that Dolibarr configuration file (<code>conf.php</code>) is writable by Web Server.|link=Special:FilePath/Avertissement_tableau_de_bord.png]]
+======Create file <code>install.lock</code>======
+The file <code>install.lock</code> is important, since it prevents that anyone can restart Dolibarr installation by accessing <code>http://localhost/dolibarr/install</code>.
+If you only use Dolibarr on your computer and that this one is not accessible from network (local or Internet), it is not necessarily necessary to create the file but it is a good habit to take because you may have to "open" your Dolibarr installation later.
+*With Windows File Explorer, go in '''Local disk (C:)''' then in directory '''dolibarr'''. Finally, go to the directory '''documents''' (<code>C:\dolibarr\documents</code>).
+*Create a file <code>install.lock</code> (right click then '''New''' > '''Text document''').
+*In your Internet browser, click again on link '''My dashboard''' in left column of Dolibarr and see that first warning about missing file <code>install.lock</code> has disappeared.
+======Restricting Web Server write access to the file <code>conf.php</code>======
+*With the '''File Explorer''' Windows, go to the '''Local Disk (C:)''' then to the directory '''Apache24'''. Go to the '''htdocs''' directory then to '''dolibarr''' and finally to '''conf''' (<code>C:\Apache24\htdocs\dolibarr\conf</code>).
+*Right click on the file <code>conf.php</code> and select the option '''Properties'''.
+*In the dialog box '''Properties of: conf.php''', check the box '''Read only''' for the option '' 'Attributes'' then click '''OK'''.
+*In your Internet Browser, click again on link '''My dashboard''' in left column of Dolibarr and see that second warning related to write accessibility to Web Server of file <code>conf.php</code> has disappeared.
+*[[File:Lecture seule fichier de configuration Dolibarr.png|none|thumb|636x636px|Enable attribute '''Read only''' for main configuration file <code>conf.php</code>of Dolibarr.|link=Special:FilePath/Lecture_seule_fichier_de_configuration_Dolibarr.png]].
+<br />
+==Appendix==
+===What are "Listening Ports" and how do I know if a program already occupies a specific port?===
+====What's a "listening port"====
+When you install a "'''Server'''" program, you must choose a port on which the program will be available and which will be used by the "'''Client'''" program to communicate with the "'''Server'''". The port is therefore the communication channel between the "'''Client'''" and the "'''Server'''" (remember the architecture diagram at the top of the page).
+The default port used by the '''MariaDB''' Database Server is '''3306'''.
+The default port used by the Web Server '''Apache2''' to communicate with the "Client" (your Internet Browser) is the port '''80'''.
+If other programs already use either port '''3306''' or port '''80''', you will need to choose another port on which the Database Server '''MariaDB''' or the Web Server '''Apache2''' will be available.
+====How do I know if a program is already occupying a specific port?====
+If you try to install the Database Server '''MariaDB''' or the Windows "Service" of the Web Server '''Apache2''' on a port which is already occupied by another program, you will encounter an error.
+To check which program is listening on which port, you can use the Windows '''Resource Monitor'''.
+*Next to the Windows button to open the start menu, in the '''Type here to search''' box, click and type <code>resource monitor</code>. In the list of options on the right, choose "'''Open'''" or click on the full title of the software to launch it ('''Resource Monitor''').
+[[File:Moniteur de ressources Windows.png|none|thumb|516x516px|Run the '''Resource Monitor''' software application of Windows|link=Special:FilePath/Moniteur_de_ressources_Windows.png]]
+*In the '''Resource Monitor''', click on the '''Network''' tab.
+*In the '''Listening Ports''' section, sort the column '''Port''' to be able to search more easily.
+*In the '''Port''' column, search for the port you are interested in (for example '''80''' for the standard port of the Web Server '''Apache2''' or '''3306''' for the Database Server '''MariaDB''').
+[[File:Ports d'écoute Windows.png|none|frame|A program "listen" already on port '''80''', it is '''httpd.exe''' (i.e. '''Apache2''').|link=Special:FilePath/Ports_d'écoute_Windows.png]]
+If you can't find a line for the port number you are looking for, then that's fine (this means that no program is listening on that port and therefore it is available).
+If, on the other hand, you find a match, then a program is already listening on this port and you will have to choose another listening port when you install your server.
+====Choose another port than the default 3306 for MariaDB====
+On the fifth page of the '''MariaDB''' installer, enter another port in the box '''TCP port:''' (eg '''3308''' - but make sure the port you choose is not already in use using the technique specified above).
+After you change port for '''MariaDB''', when you install Dolibarr, when you enter port in section '''Dolibarr database''', don't forget to enter the replacement port you chose instead of standard port '''3306'''.
+====Choose another port than the default 80 for Apache2====
+When customizing the '''Apache2''' configuration file, replace the line <code>ServerName localhost:80</code> by <code>ServerName localhost:<my_port></code> to specify another port (for example <code>ServerName localhost: 8080</code> to use port '''8080''' - but make sure the port you choose is not already in use by using the technique specified above). You will also need to replace the <code>80</code> of the <code>Listen 80</code> : line with the port number you choose.
+After changing the listening port, you will need to specify the port in the addresses you type in your browser: for example <code>http://localhost:8080</code>, <code>http://localhost:8080/test</code>, <code>http://localhost:8080/dolibarr</code>, etc. instead of <code>http://localhost</code>, <code>http://localhost/test</code>, <code>http://localhost/dolibarr</code>.
+<br />
+===How to manage Windows "Services"?===
+We have seen in this documentation the creation of Windows "Services" allowing to start automatically the Database Management System '''MariaDB''' and the Web Server '''Apache2''' at the (re)startup of the computer.
+Windows is delivered with a software allowing to manage graphically the "Services". It is thus possible to consult their status (started, stopped) and to act on them (start, stop, restart).
+*Next to the Windows button allowing to open the start menu, in the search box "'''Type here to search'''", click then type <code>services</code>. In the list of options on the right, choose "'''Open'''" or click on the full title of the software to launch it ('''Services''').
+[[File:Lancer l'application Windows Services.png|none|thumb|510x510px|Run the '''Services''' application of Windows|link=Special:FilePath/Lancer_l'application_Windows_Services.png]]
+*Find the Service for which you want to check the status or perform an action (start, stop, restart) in the list of Services that appears. For example, search for '''MariaDB''' or '''Apache2'''.
+In the column '''Status''', you can check the current status of the Service (on the screenshot below, we see that the service '''Apache2.4''' is '''Running''', ie it is started).
+*Right click on the Service to manage to display the context menu and then select the action to perform (Start, Stop or Restart).
+[[File:Redémarrer Service Apache2.4 Windows.png|none|frame|Restart the '''Apache2.4''' service|link=Special:FilePath/Redémarrer_Service_Apache2.4_Windows.png]]
+<br />
+===How do I know if my computer is running 32-bit or 64-bit version of Windows?===
+====Windows 10 and Windows 8.1====
+#Select the button '''Start''',<span class="win-icon win-icon-WindowsLogo"></span> then '''Settings''' ><span class="win-icon win-icon-Settings"></span> '''System''' > <span class="win-icon win-icon-System"></span>'''About'''.
+#<span class="win-icon win-icon-Error"></span> On the right, under '''Device Specifications''', see '''System Type'''.
+====Windows 7====
+#Select the button '''Start'''<span class="ng-isolate-scope" asset="11899" contenteditable="false" props="{"size":"full"}" readonly="true" unselectable="on"></span>, right click on '''Computer''', then choose '''Properties'''.
+#Under '''System''', see the type of system.
+===Reminder of the different installation directories used===
+{| class="wikitable"
+|+
+!Component/Software
+!Installation path
+|-
+|MariaDB
+|<code>C:\Program Files\MariaDB 10.4</code>
+|-
+|Apache 2.4
+|<code>C:\Apache24</code>
+|-
+|PHP
+|<code>C:\php</code>
+|-
+|Dolibarr (program)
+|<code>C:\Apache24\htdocs\dolibarr</code>
+|-
+|Dolibarr (documents)
+|<code>C:\dolibarr\documents</code>
+|-
+|Dolibarr (datas)
+|<code>C:\Program Files\MariaDB 10.4\data\dolibarr</code>
+|}
+<div style="background-color: lightyellow; padding:10px;">
+⚠️ '''<u>Warning!</u>''' The files present in the directory <code>C:\Program Files\MariaDB 10.4\data\dolibarr</code> are the physical files of the database. Saving these files will only allow you to reuse them with the same version of the database. A more robust way to perform a database backup is to perform an export using for example the tool '''<code>mysqldump</code>'''.
+</div>
+===How to save my manual installation===
+In Dolibarr, three things are important to save :
+*The database (MariaDB), which contains all your entries (business proposal lines, invoices, etc.).
+*the folder <code>documents</code> which contains PDF documents generated by Dolibarr (commercial proposals, invoices, etc.) as well as uploaded ones.
+*the configuration file <code>conf/config.php</code> that contains connection parameters to your database and other configuration information.
+====Backup the database====
+There are several ways to back up the database.
+=====Directly from Dolibarr=====
+[[File:Sauvegarde de la base de données depuis Dolibarr.png|thumb|Backup of the database from Dolibarr|none|750x750px|link=Special:FilePath/Sauvegarde_de_la_base_de_données_depuis_Dolibarr.png]]
+Once connected to Dolibarr,
+*Select the menu '''Backup''' in the '''Administrative Tools''',
+*In '''Compression''', select - for simplicity - '''None''' (Windows does not include a standard utility to decompress Gzip files but you can activate it if you have for example 7-Zip, PeaZip, WinZip or WinRar).
+*Click on '''Generate Backup'''.
+<br />
+[[File:Télécharger la sauvegarde de base de données.png|Download database backup|none|frame|link=Special:FilePath/Télécharger_la_sauvegarde_de_base_de_données.png]]
+Once the backup has been generated, you can download it by clicking on the link of the file in the right section '''Existing database backup files'''.
+=====Manually using the HeidiSQL graphics tool=====
+During the installation of the Database Management System '''MariaDB''', the graphical tool HeidiSQL was also installed.
+*Next to the Windows button to open the start menu, in the search box '''Type here to search''', click and type <code>heidisql</code>. In the list of options on the right, choose "'''Open'''" or click on the full title of the software to launch it ('''HeidiSQL''').
+[[File:Démarrer HeidiSQL.png|none|thumb|501x501px|Run the '''HeidiSQL''' software|link=Special:FilePath/Démarrer_HeidiSQL.png]]
+We will now define the connection to our Database Management System '''MariaDB''' using the connection information we have.
+<gallery widths="750" heights="500">
+File:Gestionnaire de sessions HeidiSQL.png|Click on '''Add'''.
+File:Paramétrages session HeidiSQL.png|For '''User:''' put '''root''' ; for '''Password''', Enter the database administrator's password that you chose when you installed MariaDB (screen 4 of the installation wizard). In '''Data base''', click on the arrow to the right of the field and select '''dolibarr'''.
+File:Renommer session HeidiSQL.png|Right-click on the item '''Unamed*''' then, in the pop-up menu, select '''Rename'''.
+File:Renommer session HeidiSQL 2.png|Enter a more meaningful name for the session name. For example '''Dolibarr'''. Then, click '''Save'''. Then click '''Open'''.
+</gallery>
+[[File:Exporter la base de données HeidiSQL.png|none|frame|Exporting the database with HeidiSQL|link=Special:FilePath/Exporter_la_base_de_données_HeidiSQL.png]]
+*Right click on the database '''<code>dolibarr</code>''' and select '''Export database to SQL...'''
+<br />
+[[File:Paramétres d'export de base de données HeidiSQL.png|none|frame|Set up the database export in '''HeidiSQL''' software|link=Special:FilePath/Paramétres_d'export_de_base_de_données_HeidiSQL.png]]
+*Check the box '''Remove/DROP''' in the section '''Table(s):''' then, in '''File name:''' choose the path where you want to export the backup and the name of the file. If you followed all installation documentation, a good practice is to place export at the same place as when you realize it with Dolibarr interface (method of above paragraph): <code>C:\dolibarr\documents\admin\backup\%db-%date.sql</code> . <code>%db</code> will be replaced automatically by database name ('''<code>dolibarr</code>''') and <code>%date</code> by date and hour of export.
+*Click on '''Export''' to launch the export.
+<br />
+=====Manually using the Windows Command Prompt=====
+*Next to the Windows button to open the start menu, in the search box "'''Type here to search'''", click and type <code>mariadb</code>. In the list of options on the right, choose "'''Open'''" or click on the full title of the software to launch it ('''Command Prompt (MariaDB 10.4 (x64))''').
+[[File:Démarrer Command Prompt (MariaDB 10.4 (x64)).png|none|thumb|550x550px|Start the '''Command Prompt (MariaDB 10.4 (x64))''']]
+Command prompt is launched; go to directory '''Dolibarr''' database backups (in our folder <code>documents</code>) :
+<syntaxhighlight lang="batch">
+cd C:\dolibarr\documents\admin\backup
+</syntaxhighlight>
+Enter the following command to save the database where <code>dolibarr-2020-05-20-14-30.sql</code> will match the name of the exported file (you can of course put whatever you want) :
+<syntaxhighlight lang="batch">
+mysqldump -u root -p --opt dolibarr > dolibarr-2020-05-20-14-30.sql
+</syntaxhighlight>
+You will be prompted to enter the database administrator's password that you chose when you installed MariaDB (screen 4 of the installation wizard).
+====Save the folder <code>documents</code> and the configuration file <code>config.php</code>====
+<div style="background-color: #DFF2FF; padding:10px;">
+ℹ️ The writing of this section is not yet complete. Please come back later.
+</div>
+=====Directly from Dolibarr=====
+<div style="background-color: #DFF2FF; padding:10px;">
+ℹ️ The writing of this section is not yet complete. Please come back later.
+</div>
+=====Manually using Windows File Explorer=====
+<div style="background-color: #DFF2FF; padding:10px;">
+ℹ️ The writing of this section is not yet complete. Please come back later.
+</div>
+====Restore a backup====
+<div style="background-color: #DFF2FF; padding:10px;">
+ℹ️ The writing of this section is not yet complete. Please come back later.
+</div>
+=====Manually using the HeidiSQL graphics tool=====
+<div style="background-color: #DFF2FF; padding:10px;">
+ℹ️ The writing of this section is not yet complete. Please come back later.
+</div>
+=====Manually using the Windows Command Prompt=====
−#
+<div style="background-color: #DFF2FF; padding:10px;">
+ℹ️ The writing of this section is not yet complete. Please come back later.
+</div>