Dolibarr ERP CRM Wiki - User contributions [en]

Dolibarr Project

2021-08-29T15:25:29Z

Gurvan: Changed the sentence about needing more people (or not)

[[fr:Projet_Dolibarr]]
[[es:Proyecto_Dolibarr]]


{{TemplateDocDevEn}}
{{TemplateDocUser}}

<div class="opacitymedium">This page provides information on Dolibarr project organization, different roles of actors and actions to help.</div>

=[[File:orientation.png]] Dolibarr history and future (Roadmap)=
See page [[Origin and history|Origin, history and future roadmap of Dolibarr]]

=[[File:who.png]] Core actors and their roles in the Dolibarr galaxy=

The current Dolibarr team is a group of people, helped (or sponsored) by miscellaneous physical or moral contributors (companies, foundations).
The following chapters presents roles and functions occupied by everybody in the Dolibarr project management. This makes it possible to understand the way the project works.
Some roles and functions are always waiting for candidates.

Volunteers to apply to a role in the project are invited to send a message on the dev mailing list of Dolibarr.

If you need information to participate as a developer, the page [[Developer_FAQ#How_to_be_an_official_developer|Developer FAQ How to be an official developer]] may be more helpful.

The following links show a list of actors that works or have worked on the Dolibarr project.

*[[:Category:Everybody|Everybody]]
*[[:Category:User Retired|All retired actors]]
*[[:Category:User Active|All active actors]]

[[Category:Proofreading done]]
The following chapters shows the different developer roles, then every non-developer roles. All these roles contributes to Dolibarr project's activity.

==Developers roles==

===Developer grade [[Developer_FAQ#Yoda|Yoda]] (GIT project and commit leader, head release manager and B.D.F.L)===

Goal/Permissions: Global management of Dolibarr project. Organize beta, create releases and packages for head branch.

Currently has this role:

{{ListOfYodas|lang=EN}}

Role need more people: No (by definition, this role is limited to the project leader and backups)

Note:
All tasks to build a package for a new Dolibarr release are defined into the file '''build/makepack-howto.txt''' available into dolibarr sources.

===Developer grade [[Developer_FAQ#Jedi|Jedi]] (maintenance release manager)===

Goal/Permissions: Create releases for maintenance versions on current and old branch.

Currently has this role to work on modules:
{{ListOfModulesWithDedicatedJedi
|lang=EN}}

Role needs more people: Yes. Please ask, if you want this role, on Dolibarr dev mailing-list.

===Developer grade [[Developer_FAQ#Admiral|Admiral]] (GIT Pull Requesters)===

Goal/Permissions: Develop, add or simply validate and commit, into GIT repository.

You become an Admiral as soon as your first GIT push request was validated. To submit new features or fixes, you must use the GIT push request system that does not need GIT write access.

Role needs more people: Yes (above all to submit bug fixes)

Article on this topic: [[Developer_FAQ#How_to_be_an_official_developer|FAQ How to become an official developer]]

Identified as having this role currently or recently (contributors found into {{TemplateURLSCM}}):

*See {{ListOfAdmirals|lang=EN}}

===Developer grade [[Developer_FAQ#Z-6PO|Z-6PO]] (Translators on transifex.com)===

Goal/Permissions: Translate files of fix translation (or typographic error).

Currently has this role:

*A lot of people are actually Z-6PO. Translation is now provided using transifex.com platform. All users that are registered as translator on Dolibarr transifex project are Z-6PO.

Role needs more people: Yes (go on https://www.transifex.com/projects/p/dolibarr/ to find your language and apply to help)

Articles on this topic: [[Translator documentation]]

===Developer grade [[Developer_FAQ#Soldier|Soldier]]===

Goal/Permissions: Animate forums, communities, promote Dolibarr, etc....

Role needs more people: Yes (no limit)

Currently has this role:

*Number too high to be counted. Any Dolibarr users are potential soldiers.

===And Darth Vader?===

There are some parasitic people that pollute the forum or mailing-list with aggressive messages, which slows the development of Dolibarr rather than help improve with constructive criticism. Some argue rudely and in bad faith. Such people are Darth Vaders.
Fortunately, statistically, there is only one or two Darth Vader per year ...

==Other roles on Dolibarr project==

===Role A: Hosting web site (https://www.dolibarr.org or local portal)===

Goal: Provide a platform and exploit it to host the Dolibarr web site (based on Joomla).

Currently has this role:
{{HosterOfWebSites}}
Role needs more people: Yes, we need people to animate and post news of websites.

===Role B: Hosting demo site (https://demo.dolibarr.org<nowiki/>)===

Goal: Provide a platform and exploit it to host the online Dolibarr demo (international version, autodetected language).

Currently has this role:

*Dolibarr foundation

Role needs more people: No

===Role C1: Hosting wiki (https://wiki.dolibarr.org<nowiki/>)===

Goal: Provide a platform and exploit it to host the Dolibarr wiki (based on mediawiki)

Currently has this role:

*Dolibarr foundation

Role needs more people: No

===Role C2: Hosting market place (https://wwww.dolistore.com<nowiki/>)===

Goal: Provide a market place to centralise all external modules (based on prestashop)

Currently has this role:

*Dolibarr foundation

Role needs more people: No

===Role E1: Responsible of DoliWamp (Dolibarr installer for Windows)===

Currently has this role:

*[[Laurent Destailleur]] ([https://www.nltechno.com NLTechno])

Role needs more people: No

===Role E2: Responsible of DoliDeb+DoliRpm (Dolibarr installer for Ubuntu/Debian/Redhat/Fedora/Mandriva/OpenSuse)===

Currently has this role:

*[[Laurent Destailleur]] ([https://www.nltechno.com NLTechno])

Role needs more people: No

===Role E3: Responsible of DoliMamp (Dolibarr installer for Mac OS X)===

Currently has this role:

*Nobody

Role needs more people: Yes

===Role G: Management of Dolibarr foundation===

Goal: Create and manage the international foundation to promote Dolibarr and help Dolibarr users.

Currently has this role:

*1 president - See page [[Dolibarr foundation]].
*1 secretary - See page [[Dolibarr foundation]].
*1 financial - See [[Dolibarr foundation]].
*Other people into the Dolibarr foundation board team: See [[Dolibarr foundation]].

===Role H: Promote/Communicate on Dolibarr===

Goal: Make '''communication''' for Dolibarr, on forums, news sites, press, etc... Write articles on Dolibarr web site.

Currently has this role:

*The [[Dolibarr foundation]]
*Role need helper. Thanks to volunteer to send a request on Dolibarr mailing-list.

Articles on this topic: [[Message samples]] used to announce new beta or release.

===Role I: Dolibarr Tester===

Goal: Test current development version of Dolibarr (GIT develop branch) and reports problems on mailing-list.

Currently has this role:

*About 50 regular users currently have this role (number obtained by analysing messages on forum), more if we add temporary testers.

===Role J: Administer domain names===
Goal: Administer DNS of dolibarr domain names. Some are not used, just reserved to avoid cyber squatting. Ask us if you plan to use one of them to build a local Dolibarr community.

Currently has this role:
{{ListOfDomainAdmins}}

=[[File:who.png]] Partners=

This the page that list known partners: [[List_of_Dolibarr_partners_and_providers]]

=[[File:workcomputer.png]] The GIT access=

The GIT server is hosted by {{TemplateUrlSCM}}

*Instructions to access GIT in read mode to get current development version are on [http://wiki.dolibarr.org/index.php/FAQ_Get,update_GIT_project_sources this page]
*To request a write access, read [[Developer FAQ#FAQ How to be an official developer|FAQ How to be an official developer]] to known how project is organized and steps to do to reach this goal.

=[[File:communaute.png]] Channels of information on social networks=
The Dolibarr foundation owns several channel networks to publish its information. Note that some members of the Dolibarr foundation may also use this channel to publish news.

See page [[FAQ How to be informed on news about Dolibarr project]]

=[[File:Lug.png]] Help the project=
This is a list of task you can do to help the project.

'''If you are a developer'''

*If you are a developer, join the Dolibarr team. See [[Developer FAQ]] for this.
*https://github.com/Dolibarr/dolibarr/blob/develop/.github/CONTRIBUTING.md

'''If you speak a non english language'''

*Translate Dolibarr application or Dolibarr web sites in your language. See [[Translator documentation]].
*Submit articles to promote Dolibarr on informations web sites on your languages or your own web site. At least, a link to web site https://www.dolibarr.org is never a bad idea.

'''If you are not a developer, nor a translator'''

*Complete documentation on this wiki, above all the section [[User documentation]].
{{Template:LinksToVoteForDolibarr}}

*You can also decide to be a member of Dolibarr foundation. See [[Subscribe|here, to subscribe]].

'''If you want to create a Dolibarr users' group or a local community'''

*Read our guideline on page [[Create a Dolibarr local community]].

=[[File:Lug.png]] DevCamps Organization=
See [[DevCamps Organization]] for this.

=[[File:Lug.png]] Donations=
Even if you don't want to be a member of the Dolibarr foundation, you can use the subscription page to donate to help development: [[Subscribe]]

[[Category:Proofreading done]]
[[Category:Development]]

Dolibarr Project

2021-08-29T15:20:42Z

Gurvan: Replaced "actually" by "currently" (different meaning from the French word "actuellement")

[[fr:Projet_Dolibarr]]
[[es:Proyecto_Dolibarr]]


{{TemplateDocDevEn}}
{{TemplateDocUser}}

<div class="opacitymedium">This page provides information on Dolibarr project organization, different roles of actors and actions to help.</div>

=[[File:orientation.png]] Dolibarr history and future (Roadmap)=
See page [[Origin and history|Origin, history and future roadmap of Dolibarr]]

=[[File:who.png]] Core actors and their roles in the Dolibarr galaxy=

The current Dolibarr team is a group of people, helped (or sponsored) by miscellaneous physical or moral contributors (companies, foundations).
The following chapters presents roles and functions occupied by everybody in the Dolibarr project management. This makes it possible to understand the way the project works.
Some roles and functions are always waiting for candidates.

Volunteers to apply to a role in the project are invited to send a message on the dev mailing list of Dolibarr.

If you need information to participate as a developer, the page [[Developer_FAQ#How_to_be_an_official_developer|Developer FAQ How to be an official developer]] may be more helpful.

The following links show a list of actors that works or have worked on the Dolibarr project.

*[[:Category:Everybody|Everybody]]
*[[:Category:User Retired|All retired actors]]
*[[:Category:User Active|All active actors]]

[[Category:Proofreading done]]
The following chapters shows the different developer roles, then every non-developer roles. All these roles contributes to Dolibarr project's activity.

==Developers roles==

===Developer grade [[Developer_FAQ#Yoda|Yoda]] (GIT project and commit leader, head release manager and B.D.F.L)===

Goal/Permissions: Global management of Dolibarr project. Organize beta, create releases and packages for head branch.

Currently has this role:

{{ListOfYodas|lang=EN}}

Role need helper: No (by definition, this role is limited to the project leader and backups)

Note:
All tasks to build a package for a new Dolibarr release are defined into the file '''build/makepack-howto.txt''' available into dolibarr sources.

===Developer grade [[Developer_FAQ#Jedi|Jedi]] (maintenance release manager)===

Goal/Permissions: Create releases for maintenance versions on current and old branch.

Currently has this role to work on modules:
{{ListOfModulesWithDedicatedJedi
|lang=EN}}

Role need helper: Yes. Please ask, if you want this role, on Dolibarr dev mailing-list.

===Developer grade [[Developer_FAQ#Admiral|Admiral]] (GIT Pull Requesters)===

Goal/Permissions: Develop, add or simply validate and commit, into GIT repository.

You become an Admiral as soon as your first GIT push request was validated. To submit new features or fixes, you must use the GIT push request system that does not need GIT write access.

Role need helper: Yes (above all to submit bug fixes)

Article on this topic: [[Developer_FAQ#How_to_be_an_official_developer|FAQ How to become an official developer]]

Identified as having this role currently or recently (contributors found into {{TemplateURLSCM}}):

*See {{ListOfAdmirals|lang=EN}}

===Developer grade [[Developer_FAQ#Z-6PO|Z-6PO]] (Translators on transifex.com)===

Goal/Permissions: Translate files of fix translation (or typographic error).

Currently has this role:

*A lot of people are actually Z-6PO. Translation is now provided using transifex.com platform. All users that are registered as translator on Dolibarr transifex project are Z-6PO.

Role need helper: Yes (go on https://www.transifex.com/projects/p/dolibarr/ to find your language and apply to help)

Articles on this topic: [[Translator documentation]]

===Developer grade [[Developer_FAQ#Soldier|Soldier]]===

Goal/Permissions: Animate forums, communities, promote Dolibarr, etc....

Role need helper: Yes (no limit)

Currently has this role:

*Number too high to be counted. Any Dolibarr users are potential soldiers.

===And Darth Vader?===

There are some parasitic people that pollute the forum or mailing-list with aggressive messages, which slows the development of Dolibarr rather than help improve with constructive criticism. Some argue rudely and in bad faith. Such people are Darth Vaders.
Fortunately, statistically, there is only one or two Darth Vader per year ...

==Other roles on Dolibarr project==

===Role A: Hosting web site (https://www.dolibarr.org or local portal)===

Goal: Provide a platform and exploit it to host the Dolibarr web site (based on Joomla).

Currently has this role:
{{HosterOfWebSites}}
Role need helper: Yes, we need people to animate and poste news of websites.

===Role B: Hosting demo site (https://demo.dolibarr.org<nowiki/>)===

Goal: Provide a platform and exploit it to host the online Dolibarr demo (international version, autodetected language).

Currently has this role:

*Dolibarr foundation

Role need helper: No

===Role C1: Hosting wiki (https://wiki.dolibarr.org<nowiki/>)===

Goal: Provide a platform and exploit it to host the Dolibarr wiki (based on mediawiki)

Currently has this role:

*Dolibarr foundation

Role need helper: No

===Role C2: Hosting market place (https://wwww.dolistore.com<nowiki/>)===

Goal: Provide a market place to centralise all external modules (based on prestashop)

Currently has this role:

*Dolibarr foundation

Role need helper: No

===Role E1: Responsible of DoliWamp (Dolibarr installer for Windows)===

Currently has this role:

*[[Laurent Destailleur]] ([https://www.nltechno.com NLTechno])

Role need helper: No

===Role E2: Responsible of DoliDeb+DoliRpm (Dolibarr installer for Ubuntu/Debian/Redhat/Fedora/Mandriva/OpenSuse)===

Currently has this role:

*[[Laurent Destailleur]] ([https://www.nltechno.com NLTechno])

Role need helper: No

===Role E3: Responsible of DoliMamp (Dolibarr installer for Mac OS X)===

Currently has this role:

*Nobody

Role need helper: Yes

===Role G: Management of Dolibarr foundation===

Goal: Create and manage the international foundation to promote Dolibarr and help Dolibarr users.

Currently has this role:

*1 president - See page [[Dolibarr foundation]].
*1 secretary - See page [[Dolibarr foundation]].
*1 financial - See [[Dolibarr foundation]].
*Other people into the Dolibarr foundation board team: See [[Dolibarr foundation]].

===Role H: Promote/Communicate on Dolibarr===

Goal: Make '''communication''' for Dolibarr, on forums, news sites, press, etc... Write articles on Dolibarr web site.

Currently has this role:

*The [[Dolibarr foundation]]
*Role need helper. Thanks to volunteer to send a request on Dolibarr mailing-list.

Articles on this topic: [[Message samples]] used to announce new beta or release.

===Role I: Dolibarr Tester===

Goal: Test current development version of Dolibarr (GIT develop branch) and reports problems on mailing-list.

Currently has this role:

*About 50 regular users currently have this role (number obtained by analysing messages on forum), more if we add temporary testers.

===Role J: Administer domain names===
Goal: Administer DNS of dolibarr domain names. Some are not used, just reserved to avoid cyber squatting. Ask us if you plan to use one of them to build a local Dolibarr community.

Currently has this role:
{{ListOfDomainAdmins}}

=[[File:who.png]] Partners=

This the page that list known partners: [[List_of_Dolibarr_partners_and_providers]]

=[[File:workcomputer.png]] The GIT access=

The GIT server is hosted by {{TemplateUrlSCM}}

*Instructions to access GIT in read mode to get current development version are on [http://wiki.dolibarr.org/index.php/FAQ_Get,update_GIT_project_sources this page]
*To request a write access, read [[Developer FAQ#FAQ How to be an official developer|FAQ How to be an official developer]] to known how project is organized and steps to do to reach this goal.

=[[File:communaute.png]] Channels of information on social networks=
The Dolibarr foundation owns several channel networks to publish its information. Note that some members of the Dolibarr foundation may also use this channel to publish news.

See page [[FAQ How to be informed on news about Dolibarr project]]

=[[File:Lug.png]] Help the project=
This is a list of task you can do to help the project.

'''If you are a developer'''

*If you are a developer, join the Dolibarr team. See [[Developer FAQ]] for this.
*https://github.com/Dolibarr/dolibarr/blob/develop/.github/CONTRIBUTING.md

'''If you speak a non english language'''

*Translate Dolibarr application or Dolibarr web sites in your language. See [[Translator documentation]].
*Submit articles to promote Dolibarr on informations web sites on your languages or your own web site. At least, a link to web site https://www.dolibarr.org is never a bad idea.

'''If you are not a developer, nor a translator'''

*Complete documentation on this wiki, above all the section [[User documentation]].
{{Template:LinksToVoteForDolibarr}}

*You can also decide to be a member of Dolibarr foundation. See [[Subscribe|here, to subscribe]].

'''If you want to create a Dolibarr users' group or a local community'''

*Read our guideline on page [[Create a Dolibarr local community]].

=[[File:Lug.png]] DevCamps Organization=
See [[DevCamps Organization]] for this.

=[[File:Lug.png]] Donations=
Even if you don't want to be a member of the Dolibarr foundation, you can use the subscription page to donate to help development: [[Subscribe]]

[[Category:Proofreading done]]
[[Category:Development]]

Dolibarr Project

2021-08-29T15:14:59Z

Gurvan: Corrected a litteral translation from French. Changed the previous sentence a bit as well

[[fr:Projet_Dolibarr]]
[[es:Proyecto_Dolibarr]]


{{TemplateDocDevEn}}
{{TemplateDocUser}}

<div class="opacitymedium">This page provides information on Dolibarr project organization, different roles of actors and actions to help.</div>

=[[File:orientation.png]] Dolibarr history and future (Roadmap)=
See page [[Origin and history|Origin, history and future roadmap of Dolibarr]]

=[[File:who.png]] Core actors and their roles in the Dolibarr galaxy=

The current Dolibarr team is a group of people, helped (or sponsored) by miscellaneous physical or moral contributors (companies, foundations).
The following chapters presents roles and functions occupied by everybody in the Dolibarr project management. This makes it possible to understand the way the project works.
Some roles and functions are always waiting for candidates.

Volunteers to apply to a role in the project are invited to send a message on the dev mailing list of Dolibarr.

If you need information to participate as a developer, the page [[Developer_FAQ#How_to_be_an_official_developer|Developer FAQ How to be an official developer]] may be more helpful.

The following links show a list of actors that works or have worked on the Dolibarr project.

*[[:Category:Everybody|Everybody]]
*[[:Category:User Retired|All retired actors]]
*[[:Category:User Active|All active actors]]

[[Category:Proofreading done]]
The following chapters shows the different developer roles, then every non-developer roles. All these roles contributes to Dolibarr project's activity.

==Developers roles==

===Developer grade [[Developer_FAQ#Yoda|Yoda]] (GIT project and commit leader, head release manager and B.D.F.L)===

Goal/Permissions: Global management of Dolibarr project. Organize beta, create releases and packages for head branch.

Has this role actualy:

{{ListOfYodas|lang=EN}}

Role need helper: No (by definition, this role is limited to the project leader and backups)

Note:
All tasks to build a package for a new Dolibarr release are defined into the file '''build/makepack-howto.txt''' available into dolibarr sources.

===Developer grade [[Developer_FAQ#Jedi|Jedi]] (maintenance release manager)===

Goal/Permissions: Create releases for maintenance versions on current and old branch.

Has this role actualy to work on modules:
{{ListOfModulesWithDedicatedJedi
|lang=EN}}

Role need helper: Yes. Please ask, if you want this role, on Dolibarr dev mailing-list.

===Developer grade [[Developer_FAQ#Admiral|Admiral]] (GIT Pull Requesters)===

Goal/Permissions: Develop, add or simply validate and commit, into GIT repository.

You become an Admiral as soon as your first GIT push request was validated. To submit new features or fixes, you must use the GIT push request system that does not need GIT write access.

Role need helper: Yes (above all to submit bug fixes)

Article on this topic: [[Developer_FAQ#How_to_be_an_official_developer|FAQ How to become an official developer]]

Identified as having this role currently or recently (contributors found into {{TemplateURLSCM}}):

*See {{ListOfAdmirals|lang=EN}}

===Developer grade [[Developer_FAQ#Z-6PO|Z-6PO]] (Translators on transifex.com)===

Goal/Permissions: Translate files of fix translation (or typographic error).

Has this role actually:

*A lot of people are actually Z-6PO. Translation is now provided using transifex.com platform. All users that are registered as translator on Dolibarr transifex project are Z-6PO.

Role need helper: Yes (go on https://www.transifex.com/projects/p/dolibarr/ to find your language and apply to help)

Articles on this topic: [[Translator documentation]]

===Developer grade [[Developer_FAQ#Soldier|Soldier]]===

Goal/Permissions: Animate forums, communities, promote Dolibarr, etc....

Role need helper: Yes (no limit)

Has this role actually:

*Number too high to be counted. Any Dolibarr users are potential soldiers.

===And Darth Vader?===

There are some parasitic people that pollute the forum or mailing-list with aggressive messages, which slows the development of Dolibarr rather than help improve with constructive criticism. Some argue rudely and in bad faith. Such people are Darth Vaders.
Fortunately, statistically, there is only one or two Darth Vader per year ...

==Other roles on Dolibarr project==

===Role A: Hosting web site (https://www.dolibarr.org or local portal)===

Goal: Provide a platform and exploit it to host the Dolibarr web site (based on Joomla).

Has this role actually:
{{HosterOfWebSites}}
Role need helper: Yes, we need people to animate and poste news of websites.

===Role B: Hosting demo site (https://demo.dolibarr.org<nowiki/>)===

Goal: Provide a platform and exploit it to host the online Dolibarr demo (international version, autodetected language).

Has this role actually:

*Dolibarr foundation

Role need helper: No

===Role C1: Hosting wiki (https://wiki.dolibarr.org<nowiki/>)===

Goal: Provide a platform and exploit it to host the Dolibarr wiki (based on mediawiki)

Has this role actually:

*Dolibarr foundation

Role need helper: No

===Role C2: Hosting market place (https://wwww.dolistore.com<nowiki/>)===

Goal: Provide a market place to centralise all external modules (based on prestashop)

Has this role actually:

*Dolibarr foundation

Role need helper: No

===Role E1: Responsible of DoliWamp (Dolibarr installer for Windows)===

Has this role actually:

*[[Laurent Destailleur]] ([https://www.nltechno.com NLTechno])

Role need helper: No

===Role E2: Responsible of DoliDeb+DoliRpm (Dolibarr installer for Ubuntu/Debian/Redhat/Fedora/Mandriva/OpenSuse)===

Has this role actually:

*[[Laurent Destailleur]] ([https://www.nltechno.com NLTechno])

Role need helper: No

===Role E3: Responsible of DoliMamp (Dolibarr installer for Mac OS X)===

Has this role actually:

*Nobody

Role need helper: Yes

===Role G: Management of Dolibarr foundation===

Goal: Create and manage the international foundation to promote Dolibarr and help Dolibarr users.

Has this role actually:

*1 president - See page [[Dolibarr foundation]].
*1 secretary - See page [[Dolibarr foundation]].
*1 financial - See [[Dolibarr foundation]].
*Other people into the Dolibarr foundation board team: See [[Dolibarr foundation]].

===Role H: Promote/Communicate on Dolibarr===

Goal: Make '''communication''' for Dolibarr, on forums, news sites, press, etc... Write articles on Dolibarr web site.

Has this role actually:

*The [[Dolibarr foundation]]
*Role need helper. Thanks to volunteer to send a request on Dolibarr mailing-list.

Articles on this topic: [[Message samples]] used to announce new beta or release.

===Role I: Dolibarr Tester===

Goal: Test current development version of Dolibarr (GIT develop branch) and reports problems on mailing-list.

Have this role actually:

*About 50 regular users have this role actually (number obtained by analysing messages on forum), more if we add temporary testers.

===Role J: Administer domain names===
Goal: Administer DNS of dolibarr domain names. Some are not used, just reserved to avoid cyber squatting. Ask us if you plan to use one of them to build a local Dolibarr community.

Have this role actually:
{{ListOfDomainAdmins}}

=[[File:who.png]] Partners=

This the page that list known partners: [[List_of_Dolibarr_partners_and_providers]]

=[[File:workcomputer.png]] The GIT access=

The GIT server is hosted by {{TemplateUrlSCM}}

*Instructions to access GIT in read mode to get current development version are on [http://wiki.dolibarr.org/index.php/FAQ_Get,update_GIT_project_sources this page]
*To request a write access, read [[Developer FAQ#FAQ How to be an official developer|FAQ How to be an official developer]] to known how project is organized and steps to do to reach this goal.

=[[File:communaute.png]] Channels of information on social networks=
The Dolibarr foundation owns several channel networks to publish its information. Note that some members of the Dolibarr foundation may also use this channel to publish news.

See page [[FAQ How to be informed on news about Dolibarr project]]

=[[File:Lug.png]] Help the project=
This is a list of task you can do to help the project.

'''If you are a developer'''

*If you are a developer, join the Dolibarr team. See [[Developer FAQ]] for this.
*https://github.com/Dolibarr/dolibarr/blob/develop/.github/CONTRIBUTING.md

'''If you speak a non english language'''

*Translate Dolibarr application or Dolibarr web sites in your language. See [[Translator documentation]].
*Submit articles to promote Dolibarr on informations web sites on your languages or your own web site. At least, a link to web site https://www.dolibarr.org is never a bad idea.

'''If you are not a developer, nor a translator'''

*Complete documentation on this wiki, above all the section [[User documentation]].
{{Template:LinksToVoteForDolibarr}}

*You can also decide to be a member of Dolibarr foundation. See [[Subscribe|here, to subscribe]].

'''If you want to create a Dolibarr users' group or a local community'''

*Read our guideline on page [[Create a Dolibarr local community]].

=[[File:Lug.png]] DevCamps Organization=
See [[DevCamps Organization]] for this.

=[[File:Lug.png]] Donations=
Even if you don't want to be a member of the Dolibarr foundation, you can use the subscription page to donate to help development: [[Subscribe]]

[[Category:Proofreading done]]
[[Category:Development]]

Installation - Upgrade

2021-07-21T18:41:57Z

Gurvan: /* With Dolibarr (standard .zip package or from git) */

[[fr:Installation_-_Mise_à_jour]]
[[es:Instalación_-_Actualización]]
[[zh:安装_-_升级]]


[[Category:Admin_en]]
{{TemplateDocUser}}

The following documentation describes processes to install or upgrade Dolibarr on a Windows, MAC OS or Unix like platform.

=Install Dolibarr=
This chapter describe different available methods to install Dolibarr for the first time (from the most simple to the manual one). See next chapter for upgrades.

==On your dedicated computer/server (installation "On Premise")==
===[[File:Logo_windows.png]] Manually or with DoliWamp===
- '''Prerequisite''': Windows

- '''Level''': Non experienced users

This process works only for Windows users and is recommended for user with no computer knowledge. If you have experience with Apache, PHP and Mysql installation, next chapter is better for you.

If you have time and want to learn how to install an Apache, PHP and MariaDB web server, see the [[Manual installation on Windows]] page for step-by-step instructions.

However, if you are a newbie user and running Windows, you can use DoliWamp. DoliWamp is a specialized Dolibarr distribution for Windows. This distribution allows you to make an installation under Windows with all prerequisites (Apache, Mysql, PHP) and with no computer knowledge. This is steps to install DoliWamp:

*Download last Dolibarr version for Windows DoliWamp.

For this, see at {{TemplateURLToDownloadDoliWamp}}

*Run the downloaded .exe and follow instructions.

===[[File:Logo_ubuntu.png]] With DoliDeb (Debian or Ubuntu .deb package)===
- '''Prerequisite''': Linux Ubuntu

- '''Level''': Non experienced users

This process works only for Ubuntu or Debian Linux users and is recommended for user with little computer knowledge. If you are experienced with Apache, PHP and Mysql installation, the chapter 'with standard package' is better for you. However, if you are a newbie user and running Ubuntu, you can use DoliDeb. DoliDeb is a specialized Dolibarr distribution for Debian or Ubuntu. This distribution allows you to make an installation under Ubuntu with all prerequisites (Apache, Mysql, PHP) and with no computer knowledge.

*Steps to install DoliDeb are described into page [[Dolibarr for Ubuntu or Debian]].

===[[File:Logo_rpm.png|42px]] With DoliRpm (Fedora, Redhat, Mandriva, Mageia or OpenSuse .rpm package)===
- '''Prerequisite''': Linux Fedora, Redhat, Mandriva, Mageia or OpenSuse

- '''Level''': Non experienced users

This process works only for Fedora, Redhat, Mandriva, Mageia or OpenSuse Linux users and is recommended for user with no computer knowledge. If you have experience with Apache, PHP and Mysql installation, next chapter 'with standard package' is better for you. However, if you are a newbie user and running Fedora or Redhat, you can use DoliRpm. DoliRpm is a specialized Dolibarr distribution for Fedora, Redhat or Mandriva. This distribution allows you to make an installation under such OS with all prerequisites (Apache, Mysql, PHP) and with no computer knowledge.

*Steps to install DoliRpm are described into page [[Dolibarr for Redhat or Fedora (rpm package)]] or [[Dolibarr for Mandriva or Mageia (rpm package)]] or [[Dolibarr for OpenSuse (rpm package)]].

===[[File:Gnu.png]] With Dolibarr (standard .zip package or from git)===
- '''Prerequisite''': Apache, 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.

This procedure describe manual (and recommended) installation on a GNU/Linux system (Debian, Mandriva, ...), it can be used for other OS with minor changes.
You can follow this tutorial for any Dolibarr version >= 2.0.0

*Check that you have installed Apache, PHP {{PHPMinVersion}} and a database server (MySQL {{MySqlMinVersion}} or PostGreSQL) correctly (check list of installed packaged on your server by using the package manager of your distribution). If not, install them (use last recent version).

*Check that main root or admin user/password couple for the server is known and works correctly. If this root or admin user/password is not known because not yet defined, read following chapter. Otherwise go on next step:

'''MySQL database :'''

For Linux users, if you have just installed a MySQL server, the admin user is''' root'''. If the root password has never been set yet, you must run the following command to initialize the password:
<source lang="bash">
mysql
</source>
Once in Mysql interface, run the SQL command to modify the root password:
<source lang="sql">
grant all privileges on *.* to root@'localhost' identified by 'newrootpass' with grant option;
</source>
Then enter and \q to quit.

To check that the connection with the new couple user/password works, launch the command
<source lang="bash">
mysql -u root -p
</source>
And type your password ''newrootpass'' then \q to quit if the connection has been successful.

'''PostgreSQL database :'''

For Linux users, if you have just installed a PostgreSQL server, you must run the following command to initialize an admin user and password. For this, add the following line in file '''/etc/postgresql/x.x/main/pg_hba.conf''' (replace x.x with your postgres version)
<source lang="ini">
local all dolibarrowner md5
</source>
Also, comment the line
<source lang="ini">
#local all all ident
</source>
This line ensure that system login used to connect to database (it will be login the web server run with), is same than database account (this is never the case).

Then launch commands from a root shell
<source lang="bash">
sudo -s -u postgres
createuser dolibarrowner
psql -U postgres -d template1
alter user dolibarrowner with password 'dolibarrownerpass';
ALTER USER dolibarrowner WITH SUPERUSER;
ALTER USER dolibarrowner WITH CREATEDB;
ALTER USER dolibarrowner WITH CREATEROLE;
\du
exit
sudo /etc/init.d/postgresql restart
</source>
You can test a connection with this user with command
<source lang="bash">
psql -d postgres -U dolibarrowner -W
</source>
And type your ''dolibarrownerpass'' as password and \q to quit if connection is ok.

'''web root :'''

*Go into the directory where to install Dolibarr (the web root directory defined for your web server)

#For Debian and Ubuntu families, it is generally: /var/www (newer versions: /var/www/html)
#For Mandriva, RedHat, Fedora: /var/www/html
#For Suse: /srv/www/htdocs

<source lang="bash">
$ cd /var/www
or
$ cd /var/www/html
</source>

*Get the application archive of last stable version

'''from zip file'''
<source lang="bash">
$ wget http://www.dolibarr.org/files/dolibarr.zip
</source>

*Uncompress archive

<source lang="bash">
$ unzip dolibarr.zip
</source>

'''or from git repository'''
<source lang="bash">
$ git clone -b X.Y http://github.com/Dolibarr/dolibarr.git dolibarr
</source>
Replace X.Y with the version you want to get.

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

<source lang="bash">
$ mv dolibarr-x.y.z dolibarr
</source>

*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
$ chown -R www-data.www-data /var/www/dolibarr
or
$ chmod -R 755 /var/www/html/dolibarr
$ chown -R apache.apache /var/www/html/dolibarr
</source>

*For Fedora, since SELinux is usually enabled, it is also advisable to run the following commands to make the 'dolibarr' directory compliant with the SELinux requirement (else you are likely to get quite a few alerts) :

<source lang="bash">
$ semanage fcontext -a -t httpd_sys_rw_content_t '/var/www/html/dolibarr(/.*)?'
$ restorecon -R -v '/var/www/html/dolibarr'
</source>

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

<source lang="bash">
$ cd dolibarr ; touch htdocs/conf/conf.php ; chown www-data htdocs/conf/conf.php
</source>
Note: For Ubuntu no need of htdocs, you just have to make dolibarr root by placing all files and folders of htdocs in /var/www/dolibarr then from browser do <MyIP>/dolibarr/index.php (see this discussion as reference to this addendum [http://askubuntu.com/questions/874456/php-code-displays-in-browser?noredirect=1#comment1357943_874456])

*As a root user, create a directory that will be used to save all files 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, apache on Mandriva, RedHat, Fedora...). The web server must have write permission into this directory. It is recommanded to use a directory outside of your directory of web pages, for example - "/var/lib/dolibarr/documents"

<source lang="bash">
$ mkdir -p /var/lib/dolibarr/documents ; chown www-data /var/lib/dolibarr/documents
</source>

*Now call your browser to point to the main page

<source lang="ini">
http://127.0.0.1/dolibarr/htdocs/
</source>
or if you didn't create the htdocs directory
<source lang="ini">
http://127.0.0.1/dolibarr/
</source>

*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 document directory that only root user can delete. This will lock the call of the install process again (you will have to remove this file for upgrades).

If this is not done, Dolibarr will show you a warning once logged by an administrator user.
<source lang="bash">
$ touch /var/lib/dolibarr/documents/install.lock; chmod go-w /var/lib/dolibarr/documents;
</source>

==On a mutualized Web Hosting Provider (without terminal/SSH access)==
It is not possible to provide a generic documentation to install Dolibarr on a particular Web hosting provider as this depends on provider.
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.

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

[[File:warning.png]] Warning, check that code page of PHP server and database server are same (utf8 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.

*Get the application archive of last stable version and uncompress it locally.

*Upload all content of htdocs directory to your web root directory, for example using FTP in binary mode.

*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

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

==On a SaaS or Cloud web hosting provider==
Dolibarr is also available on a lot of "ready to use" SaaS or Cloud platforms/services that provides preinstalled versions.

See page [[Cloud Solutions]].

Dolibarr can also be installed manually on all Cloud platforms that support PHP and Mysql.

See page [[Cloud Solutions]].

==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
git clone https://github.com/Dolibarr/dolibarr/
cd ./dolibarr
git checkout tags/<desiredrelease>

cd build/docker

docker-compose up

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=

==First setup==
See page [[First setup|Setup]].

==Setup a LDAP connection==
If you want to use a LDAP: See [[Install and configure OpenLDAP]].

=Import external data=
For this operation, read page [[Mass imports]].

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

==[[File:Logo_windows.png]] With DoliWamp (Windows .exe package)==

*First make a backup of your current installation
*Download new .exe package of DoliWamp.
*Run downloaded .exe file and follow steps without changing any default values. This will upgrades all your files.
*At the end of the execution, your browser is launched with a page to ask you to run upgrade of your database. Choose the upgrade according to your case.

If there is more than one version late, the page in your browser will loop to start again the upgrade wizard as often as required to run upgrade process, version by version, until your reach the new installed version.

==[[File:Logo_ubuntu.png]] With DoliDeb (Debian or Ubuntu .deb package)==

*First make a backup of your current installation
*Process to upgrade using Debian/Ubuntu package is the same as the install process (see previous chapters), so it is as easy as installing a package.

You can also read page [[Dolibarr for Ubuntu or Debian]].

==[[File:Logo_rpm.png|40px]] With DoliRpm (Fedora, Redhat, Mandriva, Mageia or OpenSuse .rpm package)==

*First make a backup of your current installation
*Process to upgrade using rpm package is the same as the install process, so it is as easy as installing a package (see previous chapters).

==[[File:Gnu.png]] With Dolibarr (standard .zip package or from Git)==
This is tutorial to use when using standard distribution for a manual upgrade.

*First make a backup of your current installation

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

<source lang="bash">
$ cd /var/www
</source>

===For installation that used the zip file===

*Get archive of last version

<source lang="bash">
$ wget https://www.dolibarr.org/files/dolibarr.zip
</source>

*Uncompress the archive

<source lang="bash">
$ unzip dolibarr.zip
</source>

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

<source lang="bash">
$ cp -r dolibarr-x.y.z/* dolibarr
</source>

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

<source lang="bash">
$ rm -fr dolibarr-x.y.z
</source>

*Now open your Dolibarr in your browser. It should open automatically the install/

and choose ''Update'' in suggested menu.

===For installation that used GIT===
If you already cloned the repo simply upgrade by checking out a version tag like so:
<source lang="bash">
$ git checkout -b 13.0 --depth 1
</source>

*Now open your Dolibarr in your browser. It should open automatically the install/

and choose ''Update'' in suggested menu.

Note:

If you want to script the database upgrade process (to avoid the upgrade process from web browser), you can run the 3 upgrade processes from command line:
<source lang="bash">
$ cd htdocs/install
$ php upgrade.php oldx.oldy.oldz x.y.z > output.html
$ php upgrade2.php oldx.oldy.oldz x.y.z > output2.html
$ php step5.php oldx.oldy.oldz x.y.z > 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).

Note: 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.

*For security reason, once setup is finished, you should create a file install.lock into Dolibarr documents directory. This will lock the call of the install process again (you will have to remove this file for future upgrades). If this is not done, Dolibarr will show you a warning once logged with an administrator user.

<source lang="bash">
$ echo > documents/install.lock
$ chmod 444 documents/install.lock
</source>