Dolibarr ERP CRM Wiki

Changes

Installation - Upgrade (view source)

Revision as of 17:20, 7 January 2025

1,406 bytes added ,  2 months ago
m
no edit summary
Line 6: Line 6:  
[[zh:安装_-_升级]]
 
[[zh:安装_-_升级]]
 
<!-- END interlang links -->
 
<!-- END interlang links -->
 +
[[Category:Admin_en]]
   −
[[Category:Admin_en]]
   
{{TemplateDocUser}}
 
{{TemplateDocUser}}
   Line 133: Line 133:  
</source>
 
</source>
   −
*Get the application archive of last stable version '''from zip file''' <source lang="bash">
+
*Get the application archive of last stable version '''from zip file'''
−
$ wget http://www.dolibarr.org/files/dolibarr.zip
+
 
−
</source>  Uncompress archive<source lang="bash">
+
For this, see at [https://sourceforge.net/projects/dolibarr/files/Dolibarr%20ERP-CRM/ Sourceforge Mirror] and get the latest stable version url
 +
$ wget -O dolibarr.zip https://sourceforge.net/projects/dolibarr/files/Dolibarr%20ERP-CRM/x.y.z/dolibarr-x.y.z.zip/download
 +
 
 +
 
 +
Uncompress archive<source lang="bash">
 
$ unzip dolibarr.zip
 
$ unzip dolibarr.zip
 
</source>  '''or from git repository'''<source lang="bash">
 
</source>  '''or from git repository'''<source lang="bash">
Line 147: Line 151:  
*Change permissions and owner of the 'dolibarr' directory to that of the group under which the web server runs (assumed to be 'www-data' for debian, 'apache' for redhat, mandriva, fedora)<source lang="bash">
 
*Change permissions and owner of the 'dolibarr' directory to that of the group under which the web server runs (assumed to be 'www-data' for debian, 'apache' for redhat, mandriva, fedora)<source lang="bash">
 
$ chmod -R 755 /var/www/dolibarr
 
$ chmod -R 755 /var/www/dolibarr
−
$ chown -R www-data.www-data /var/www/dolibarr
+
$ chown -R www-data:www-data /var/www/dolibarr
 
or
 
or
 
$ chmod -R 755 /var/www/html/dolibarr
 
$ chmod -R 755 /var/www/html/dolibarr
−
$ chown -R apache.apache /var/www/html/dolibarr
+
$ chown -R apache:apache /var/www/html/dolibarr
 
</source>
 
</source>
   Line 177: Line 181:  
$ touch /var/lib/dolibarr/documents/install.lock; chmod go-w /var/lib/dolibarr/documents;
 
$ touch /var/lib/dolibarr/documents/install.lock; chmod go-w /var/lib/dolibarr/documents;
 
</source>
 
</source>
 +
 +
 +
====Additional information on setting up a Debian or Ubuntu server====
 +
If you are planning to configure a Debian or Ubuntu server for Dolibarr to provide the aforementioned prerequisites, there are detailed step-by-step instructions available in German:
 +
 +
*[https://wiki.dolibarr.org/Installieren_und_H%C3%A4rten_von_Dolibarr Installation and hardening] ''(German)''
 +
 +
*''[https://wiki.dolibarr.org/ModSecurity_f%C3%BCr_Dolibarr Install ModSecurity für Dolibarr] (German)''
 +
 +
      Line 183: Line 197:  
In most cases, using the following process should works for most providers:
 
In most cases, using the following process should works for most providers:
   −
- '''Prerequisite''': Apache web server, PHP and a database server (MySQL or PostgreSQL) are already running correctly and user/pass (of a new database or root server) is known.
+
- '''Prerequisites''': Apache web server, PHP and a database server (MySQL or PostgreSQL) are already running correctly and user/pass (of a new database or root server) is known.
    
- '''Level''': Users with few Web and Database administration knowledge. Knowledge to use a tool (FTP, SFTP) to upload files on the server.
 
- '''Level''': Users with few Web and Database administration knowledge. Knowledge to use a tool (FTP, SFTP) to upload files on the server.
   −
*Check that you have an Apache web server, PHP and a database server (MySQL or PostGreSQL) that works correctly.
+
*Check that you have an Apache web server, PHP and a database server (MySQL(recommended) or PostGreSQL) that works correctly.
   −
[[File:warning.png]] Warning, check that code page of PHP server and database server are same (utf8 recommended).
+
[[File:warning.png]] Warning, check that code page of PHP server and database server are same (<dfn>utf8_general_c</dfn>i recommended).
    
*Check that main root or admin user/password couple for the server is known and works correctly. Ask them to your Web Hosting Provider if unknown.
 
*Check that main root or admin user/password couple for the server is known and works correctly. Ask them to your Web Hosting Provider if unknown.
   −
*Get the application archive of last stable version and uncompress it locally.
+
*Get the application archive of last stable version from [https://sourceforge.net/projects/dolibarr/files/Dolibarr&#x20;ERP-CRM/ here] and uncompress it locally.
   −
*Upload all content of htdocs directory to your web root directory, for example using FTP in binary mode.
+
*Create a folder named dolibarr inside your web root directory(usually called public_html) and upload all content of htdocs directory to it. You can use an FTP client like [https://filezilla-project.org/download.php?type=client22 Filezilla].
    
*Create a directory called "documents" into Dolibarr directory that will serve to save all documents generated and stocked by Dolibarr (PDF invoices, uploaded images, ...). The web server must have write permission into this directory. You can set permissions with your FTP client.
 
*Create a directory called "documents" into Dolibarr directory that will serve to save all documents generated and stocked by Dolibarr (PDF invoices, uploaded images, ...). The web server must have write permission into this directory. You can set permissions with your FTP client.
   −
*Now call your browser to point to the main page index.php
+
*Using your browser point to the main page index.php e.g. dolibarr.mydomain.com/index.php
    
*Follow instructions of setup steps until end of install process.
 
*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. 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 once logged as an administrator user.
+
*For security reason, it's strongly recommended, once setup is finished, to create a file named '''install.lock''' into documents directory. 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 once logged as an administrator user.
      Line 219: Line 233:     
==Installation using Docker==
 
==Installation using Docker==
−
For admins with Docker experience, it is possible to use the docker build files located in the source repo here: https://github.com/Dolibarr/dolibarr/tree/develop/build
+
===Using the official docker image===
 +
See the README at https://hub.docker.com/r/dolibarr/dolibarr
 +
 
 +
===Building your own docker image===
 +
For admins with Docker experience, it is possible to use the docker build files located in the source repository here: https://github.com/Dolibarr/dolibarr/tree/develop/build
 
  git clone https://github.com/Dolibarr/dolibarr/
 
  git clone https://github.com/Dolibarr/dolibarr/
 
  cd ./dolibarr
 
  cd ./dolibarr
Line 229: Line 247:       −
 
+
Read the README carefully. As of version 12+ it recommends to use the built in docker files for development only, while the outside repo: https://hub.docker.com/r/dolibarr/dolibarr is recommended for production environments.
−
 
  −
Read the README carefully. As of version 12+ it recommends to use the built in docker files for development only, while an outside repo: https://hub.docker.com/r/tuxgasy/dolibarr is recommended for production environments.
      
=Setup=
 
=Setup=
Line 247: Line 263:     
=Upgrade Dolibarr=
 
=Upgrade Dolibarr=
−
This chapter describe processes to upgrade an existing installation of Dolibarr from an old version to a new one. The process is the same, whatever version you are coming from and version you are going to, but it will differ according to the distribution/operating system you used for your first installation. You should use the same for upgrade.
+
This chapter describes the process to upgrade an existing installation of Dolibarr from an old version to a new one. The process is the same, whatever is the version you are coming from and the version you are going to, but it will differ according to the distribution/operating system you used for your first installation. You should use the same for upgrade.
      −
'''Note''' (optional but recommended):
+
'''Note''' (optional):
   −
It's better to delete old scripts (and programms if included in the downloaded file) before installing new ones: old files can remain, causing bug and malfunctions.
+
It's better to delete old program files before installing the new ones: old files can remain, causing bug and malfunctions.
   −
Before deleting, remember to save what you have customiz in your installation:
+
Before deleting, remember to save what you have customized in your installation:
    
*your data (documents folder and database)
 
*your data (documents folder and database)
Line 298: Line 314:  
===For installation that used the zip file===
 
===For installation that used the zip file===
   −
*Get archive of last version<source lang="bash">
+
*Get the application archive of last stable version '''from zip file'''
−
$ wget https://www.dolibarr.org/files/dolibarr.zip
+
 
−
</source>
+
For this, see at [https://sourceforge.net/projects/dolibarr/files/Dolibarr%20ERP-CRM/ Sourceforge Mirror] and get the latest stable version url
 +
$ wget -O dolibarr.zip https://sourceforge.net/projects/dolibarr/files/Dolibarr%20ERP-CRM/x.y.z/dolibarr-x.y.z.zip/download
    
*Uncompress the archive<source lang="bash">
 
*Uncompress the archive<source lang="bash">
Line 323: Line 340:  
</source>
 
</source>
   −
*Now open your Dolibarr in your browser. It should open automatically the install/ and choose ''Update'' in suggested menu.
+
*Now open your Dolibarr in your browser. It should open automatically the install/ page. Choose ''Update'' in the suggested options.
−
 
      
==Notes on the Upgrade==
 
==Notes on the Upgrade==
Line 342: Line 358:  
</source> Note: z must be "0" because only major versions have a migration script to run. Return code will be 0 if success, 1 if error (if this happens, see file output.html, output2.html or output3.html).
 
</source> Note: z must be "0" because only major versions have a migration script to run. Return code will be 0 if success, 1 if error (if this happens, see file output.html, output2.html or output3.html).
    +
=Related videos=
 +
Install on local :
 +
(vocal in french but subtitles are available and review in this language)
   −
== Additional information on setting up a server ==
+
<youtube width="200" height="120">N0iweN8ukVU</youtube>
−
If you are planning to configure a Debian or Ubuntu server for Dolibarr, there are detailed step-by-step instructions available in German:
     −
* [https://wiki.dolibarr.org/Installieren_und_H%C3%A4rten_von_Dolibarr Installation and hardening] ''(German)''
+
Install on server Infomaniak :
 +
(vocal in french but subtitles are available and review in this language)
   −
*''[https://wiki.dolibarr.org/ModSecurity_f%C3%BCr_Dolibarr Install ModSecurity für Dolibarr] (German)''
+
<youtube width="200" height="120">jsi1D4L1WAI</youtube>
 +
 
 +
Installation and migration to V15 on local :  
 +
(vocal in french but subtitles are available and review in this language)
 +
 
 +
<youtube width="200" height="120">LKdQvRVxYKs</youtube>
Retrieved from "https://wiki.dolibarr.org/index.php?title=Special:MobileDiff/53782...62131"