Quellen-Installation¶
Bei der „Quelleninstallation“ geht es nicht darum, Odoo zu installieren, sondern direkt aus dem Quellcode zu starten.
Für Modulentwickler kann es bequemer sein, da der Odoo-Quellcode leichter zugänglich ist als bei Installationsprogrammen.
Es macht das Starten und Stoppen von Odoo flexibler und expliziter als die von den Installationsprogrammen eingerichteten Dienste und ermöglicht das Überschreiben von Einstellungen mit Befehlszeilenparametern, ohne dass Sie eine Konfigurationsdatei bearbeiten müssen.
Schließlich bietet es eine bessere Kontrolle über die Einrichtung des Systems und ermöglicht es, mehrere Versionen von Odoo nebeneinander zu führen und zu nutzen.
Die Quellen abrufen¶
Es gibt zwei Möglichkeiten, den Quellcode von Odoo zu erhalten: als ZIP-Archiv oder über Git.
Archiv¶
Community-Edition:
Enterprise-Edition:
Git¶
Bemerkung
Es ist erforderlich, dass Sie Git installiert haben, und es wird empfohlen, dass Sie über Grundkenntnisse der Git-Befehle verfügen, um fortzufahren.
Um ein Git-Repository zu klonen, wählen Sie zwischen dem Klonen mit HTTPS oder SSH. In den meisten Fällen ist HTTPS die beste Option. Wählen Sie jedoch SSH, wenn Sie zum Odoo-Quellcode beitragen oder wenn Sie dem Getting Started developer tutorial folgen.
$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git
$ git clone git@github.com:odoo/odoo.git
$ git clone git@github.com:odoo/enterprise.git
C:\> git clone https://github.com/odoo/odoo.git
C:\> git clone https://github.com/odoo/enterprise.git
C:\> git clone git@github.com:odoo/odoo.git
C:\> git clone git@github.com:odoo/enterprise.git
$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git
$ git clone git@github.com:odoo/odoo.git
$ git clone git@github.com:odoo/enterprise.git
Bemerkung
Das Enterprise-Git-Repository enthält nicht den vollständigen Odoo-Quellcode. Es handelt sich lediglich um eine Sammlung von zusätzlichen Add-Ons. Der Hauptcode des Servers befindet sich in der Community-Version. Wenn Sie die Enterprise-Version ausführen, müssen Sie den Server von der Community-Version aus starten und die Option addons-path auf den Ordner mit der Enterprise-Version setzen. Sie müssen sowohl das Community- als auch das Enterprise-Repository klonen, um eine funktionierende Odoo-Enterprise-Installation zu erhalten.
Vorbereiten¶
Python¶
Odoo benötigt Python 3.7 oder höher, um zu funktionieren.
Verwenden Sie bei Bedarf einen Paketmanager, um Python 3 herunterzuladen und zu installieren.
Laden Sie die neueste Version von Python 3 herunter und installieren Sie sie.
Aktivieren Sie während der Installation das Kontrollkästchen Add Python 3 to PATH (Python 3 zu PATH hinzufügen), klicken Sie dann auf Customize Installation (Installation anpassen) und vergewissern Sie sich, dass pip markiert ist.
Bemerkung
Wenn Python 3 bereits installiert ist, stellen Sie sicher, dass die Version 3.7 oder höher ist, da frühere Versionen nicht mit Odoo kompatibel sind.
$ python3 --version
C:\> python --version
$ python3 --version
Überprüfen Sie auch, ob pip für diese Version installiert ist.
$ pip3 --version
C:\> pip --version
$ pip3 --version
PostgreSQL¶
Odoo verwendet PostgreSQL als Datenbankverwaltungssystem.
Verwenden Sie einen Paketmanager, um PostgreSQL herunterzuladen und zu installieren (unterstützte Versionen: 12.0 oder höher). Führen Sie dazu Folgendes aus:
$ sudo apt install postgresql postgresql-client
Laden Sie PostgreSQL (unterstützte Versionen: 12.0 oder höher) herunter und installieren Sie es.
Verwenden Sie postgres.app, um PostgreSQL herunterzuladen und zu installieren (unterstützte Version: 12.0 oder höher).
Tipp
Um die mit Postgres.app gebündelten Befehlszeilentools verfügbar zu machen, stellen Sie sicher, dass Sie Ihre $PATH-Variable einrichten, indem Sie die Postgres.app CLI Tools Instructions ( Anweisungen für Befehlzeilentools für Postgres.app) befolgen.
Standardmäßig ist der einzige Benutzer postgres. Da Odoo verbietet die Verbindung als postgres, sodass Sie einen neuen PostgreSQL-Benutzer anlegen müssen.
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
Bemerkung
Da der PostgreSQL-Benutzer denselben Namen wie Ihr Unix-Login hat, können Sie sich ohne Passwort mit der Datenbank verbinden.
Fügen Sie das
bin-Verzeichnis von PostgreSQL (standardmäßig:C:\Programme\PostgreSQL\<version>\bin) zumPATHhinzu.Erstellen Sie einen Postgres-Benutzer mit einem Passwort über die GUI des PG-Admins:
Öffnen Sie pgAdmin.
Doppelklicken Sie auf den Server, um eine Verbindung herzustellen.
Wählen Sie (Objekt –> Erstellen –> Login/Gruppenrolle).
Geben Sie den Benutzernamen in das Feld Role Name (Rollenname) ein (z. B.
odoo).Öffnen Sie den Reiter Definition und geben Sie das Passwort ein (z. B.
odoo), dann klicken Sie auf Save (Speichern).Öffnen Sie den Reiter Privileges (Privilegien) und setzen Sie Can login? (Kann anmelden?) auf
Yes(Ja) und Create database? (Datenbank erstellen?) aufYes(Ja).
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
Bemerkung
Da der PostgreSQL-Benutzer denselben Namen wie Ihr Unix-Login hat, können Sie sich ohne Passwort mit der Datenbank verbinden.
Abhängigkeiten¶
Die bevorzugte Methode zur Installation von Abhängigkeiten ist die Verwendung der Distributionspakete. Alternativ können Sie die Python-Abhängigkeiten auch mit pip installieren.
Unter Debian/Ubuntu sollten die folgenden Befehle die erforderlichen Pakete installieren:
$ cd odoo #CommunityPath
$ sudo ./setup/debinstall.sh
The setup/debinstall.sh script will parse the debian/control file and install the found packages.
Warnung
Die Verwendung von pip kann zu Sicherheitsproblemen und kaputten Abhängigkeiten führen; tun Sie dies nur, wenn Sie wissen, was Sie tun.
Da einige der Python-Pakete einen Kompilierungsschritt benötigen, müssen die Systembibliotheken installiert werden.
Unter Debian/Ubuntu sollte der folgende Befehl die erforderlichen Bibliotheken installieren:
$ sudo apt install python3-pip libldap2-dev libpq-dev libsasl2-dev
Die Abhängigkeiten von Odoo sind in der Datei requirements.txt aufgeführt, die sich im Stammverzeichnis von Odoo Community befindet.
Bemerkung
Die Python-Pakete in requirements.txt basieren auf der entsprechenden stabilen/LTS Debian/Ubuntu-Version zum Zeitpunkt der Odoo-Veröffentlichung. Für Odoo 15.0 zum Beispiel ist die Version des Pakets python3-babel 2.8.0 in Debian Bullseye und 2.6.0 in Ubuntu Focal. Die niedrigste Version wird dann in der requirements.txt ausgewählt.
Tipp
Es kann sinnvoll sein, die Pakete der Python-Module nicht zwischen verschiedenen Instanzen von Odoo oder mit Ihrem System zu mischen. Sie können virtualenv verwenden, um isolierte Python-Umgebungen zu erstellen.
Navigieren Sie zum Pfad der Odoo-Community-Installation (CommunityPath) und führen Sie pip auf die Anforderungsdatei aus, um die Anforderungen für den aktuellen Benutzer zu installieren.
$ cd /CommunityPath
$ pip install -r requirements.txt
Bevor Sie die Abhängigkeiten installieren, müssen Sie die Build-Tools für Visual Studio herunterladen und installieren. Wählen Sie C++ build tools (Build-Tools C++) im Reiter Workloads und installieren Sie sie, wenn Sie dazu aufgefordert werden.
Die Abhängigkeiten von Odoo sind in der Datei requirements.txt aufgeführt, die sich im Stammverzeichnis von Odoo Community befindet.
Tipp
Es kann sinnvoll sein, die Pakete der Python-Module nicht zwischen verschiedenen Instanzen von Odoo oder mit Ihrem System zu mischen. Sie können virtualenv verwenden, um isolierte Python-Umgebungen zu erstellen.
Navigieren Sie zu dem Pfad der Odoo-Community-Installation (CommunityPath) und führen Sie pip auf der Anforderungsdatei in einem Terminal mit Administratorrechten aus:
C:\> cd \CommunityPath
C:\> pip install setuptools wheel
C:\> pip install -r requirements.txt
Die Abhängigkeiten von Odoo sind in der Datei requirements.txt aufgeführt, die sich im Stammverzeichnis von Odoo Community befindet.
Tipp
Es kann sinnvoll sein, die Pakete der Python-Module nicht zwischen verschiedenen Instanzen von Odoo oder mit Ihrem System zu mischen. Sie können virtualenv verwenden, um isolierte Python-Umgebungen zu erstellen.
Navigieren Sie zu dem Pfad der Odoo-Community-Installation (CommunityPath) und führen Sie pip auf der Anforderungsdatei aus:
$ cd /CommunityPath
$ pip3 install setuptools wheel
$ pip3 install -r requirements.txt
Bemerkung
Für Sprachen mit Rechts-nach-Links-Schnittstelle (wie Arabisch oder Hebräisch) wird das Paket rtlcss benötigt.
Laden Sie nodejs und npm mit einem Paketmanager herunter und installieren Sie sie.
Installieren Sie
rtlcss:$ sudo npm install -g rtlcss
Warnung
wkhtmltopdf wird nicht über pip installiert und muss in Version 0.12.6 manuell installiert werden, damit es Kopf- und Fußzeilen unterstützt. Weitere Einzelheiten zu den verschiedenen Versionen finden Sie in unserem wkhtmltopdf-Wiki.
Odoo starten¶
Sobald alle Abhängigkeiten eingerichtet sind, können Sie Odoo starten, indem Sie odoo-bin, die Befehlszeilenschnittstelle des Servers, ausführen. Sie befindet sich im Stammverzeichnis des Odoo-Community-Verzeichnisses.
Um den Server zu konfigurieren, können Sie entweder Befehlszeilenargumente oder eine Konfigurationsdatei angeben.
Tipp
Fügen Sie für die Enterprise-Edition den Pfad zu den enterprise-Add-ons zum Argument addons-path hinzu. Beachten Sie, dass dieser Pfad vor den anderen Pfaden in addons-path stehen muss, damit die Add-ons korrekt geladen werden.
Übliche notwendige Konfigurationen sind:
PostgreSQL-Benutzer und Passwort.
Benutzerdefinierte Add-on-Pfade über die Standardeinstellungen hinaus, um benutzerdefinierte Module zu laden.
Eine typische Art, den Server zu betreiben, starten:
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
Dabei steht CommunityPath für den Pfad der Odoo-Community-Installation und mydb für den Namen der PostgreSQL-Datenbank.
C:\> cd CommunityPath/
C:\> python odoo-bin -r dbuser -w dbpassword --addons-path=addons -d mydb
Dabei steht CommunityPath für den Pfad der Odoo-Community-Installation, dbuser für das PostgreSQL-Login, dbpassword für das PostgreSQL-Passwort und mydb für den Namen der PostgreSQL-Datenbank.
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
Dabei steht CommunityPath für den Pfad der Odoo-Community-Installation und mydb für den Namen der PostgreSQL-Datenbank.
Nachdem der Server gestartet wurde (das INFO-Protokoll odoo.modules.loading: Modules loaded. wird ausgegeben), öffnen Sie http://localhost:8069 in Ihrem Webbrowser und melden Sie sich mit dem Konto des Basisadministrators in der Odoo-Datenbank an: Verwenden Sie admin als E-Mail und noch einmal admin für das Passwort.
Tipp