Bron installatie

De bron-‘installatie’ gaat niet over het installeren van Odoo, maar over het rechtstreeks vanaf de bron uitvoeren.

Het gebruik van de Odoo-broncode kan handiger zijn voor moduleontwikkelaars, omdat deze gemakkelijker toegankelijk is dan het gebruik van verpakte installatieprogramma’s.

Het maakt het starten en stoppen van Odoo flexibeler en explicieter dan de diensten die zijn opgezet door de verpakte installatieprogramma’s. Het maakt het ook mogelijk instellingen te overschrijven met behulp van opdrachtregelparameters zonder dat een configuratiebestand hoeft te worden bewerkt.

Ten slotte biedt het meer controle over de systeeminstellingen en maakt het het gemakkelijker om meerdere versies van Odoo naast elkaar te houden (en uit te voeren).

Haal de bronnen op

Er zijn twee manieren om de broncode van Odoo te verkrijgen: als ZIP archief of via Git.

Archiveren

Community-editie:

Bedrijfseditie:

Git

Notitie

Het is vereist dat Git geïnstalleerd is, en het wordt aanbevolen om een basiskennis van Git-commando’s te hebben om verder te kunnen gaan.

To clone a Git repository, choose between cloning with HTTPS or SSH. In most cases, the best option is HTTPS. However, choose SSH to contribute to Odoo source code or when following the Getting Started developer tutorial.

$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git

Notitie

De Enterprise git-repository bevat niet de volledige Odoo-broncode. Het is slechts een verzameling extra add-ons. De hoofdservercode bevindt zich in de Community-editie. Het uitvoeren van de Enterprise-versie betekent dat de server wordt uitgevoerd vanaf de Community-versie met de optie addons-path ingesteld op de map met de Enterprise-editie. Het is vereist om zowel de Community- als de Enterprise-repository te klonen om een werkende Odoo Enterprise-installatie te hebben.

Voorbereiden

Python

Odoo requires Python 3.7 or later to run.

Gebruik indien nodig een pakketbeheerder om Python 3 te downloaden en te installeren.

Notitie

If Python 3 is already installed, make sure that the version is 3.7 or above, as previous versions are not compatible with Odoo.

$ python3 --version

Controleer of pip ook voor deze versie is geïnstalleerd.

$ pip3 --version

PostgreSQL

Odoo gebruikt PostgreSQL als databasebeheersysteem.

Gebruik een pakketbeheerder om PostgreSQL te downloaden en te installeren (ondersteunde versies: 12.0 of hoger). Dit kan worden bereikt door het volgende uit te voeren:

$ sudo apt install postgresql postgresql-client

Standaard is de enige gebruiker postgres. Omdat Odoo het verbinden als postgres verbiedt, moet je een nieuwe PostgreSQL-gebruiker maken.

$ sudo -u postgres createuser -s $USER
$ createdb $USER

Notitie

Omdat de PostgreSQL-gebruiker dezelfde naam heeft als de Unix-login, is het mogelijk om zonder wachtwoord verbinding te maken met de database.

Afhankelijkheden

Het gebruik van distributiepakketten is de beste manier om afhankelijkheden te installeren. Je kunt ook de Python-afhankelijkheden installeren met pip.

Op Debian/Ubuntu zouden de volgende opdrachten de vereiste pakketten moeten installeren:

$ cd odoo #CommunityPath
$ sudo ./setup/debinstall.sh

The setup/debinstall.sh script will parse the debian/control <https://github.com/odoo/odoo/blob/15.0/debian/control> file and install the found packages.

Notitie

Voor talen die een van rechts naar links-interface gebruiken (zoals Arabisch of Hebreeuws), is het pakket rtlcss vereist.

  1. Download en installeer nodejs en npm met een pakketbeheerder.

  2. Installeer rtlcss:

    $ sudo npm install -g rtlcss
    

Waarschuwing

wkhtmltopdf is not installed through pip and must be installed manually in version 0.12.5 for it to support headers and footers. Check out the wkhtmltopdf wiki for more details on the various versions.

Odoo jeitvoeren

Zodra alle afhankelijkheden zijn ingesteld, kan Odoo worden gestart door odoo-bin uit te voeren, de opdrachtregelinterface van de server. Het bevindt zich in de hoofdmap van de Odoo Community-map.

Om de server te configureren, specificeer je opdrachtregelargumenten of een configuratiebestand.

Tip

Voor de Enterprise-editie voeg je het pad naar de enterprise-add-ons toe aan het addons-path-argument. Merk op dat het vóór de andere paden in addons-path moet komen om add-ons correct te laden.

Veel voorkomende noodzakelijke configuraties zijn:

  • PostgreSQL-gebruiker en wachtwoord.

  • Aangepaste add-onpaden die verder gaan dan de standaardwaarden om aangepaste modules te laden.

Een typische manier om de server te laten draaien is:

$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb

Waar ‘CommunityPath’ het pad is van de Odoo Community-installatie, en ‘mydb’ de naam is van de PostgreSQL-database.

Nadat de server is gestart (het INFO-logboek odoo.modules.loading: Modules geladen. wordt afgedrukt), open je http://localhost:8069 in een webbrowser en logt je in op de Odoo-database met het basisbeheerdersaccount: gebruik ` admin` als e-mailadres en nogmaals admin als wachtwoord.

Tip

  • Van daaruit maakt en beheer je nieuwe users.

  • Het gebruikersaccount dat wordt gebruikt om in te loggen op de webinterface van Odoo verschilt van de :option:`–db_user<odoo-bin -r> ` CLI-argument.