Source¶
L’installation de la source ne consiste pas à installer Odoo mais à l’exécuter directement à partir de la source.
L’utilisation de la source Odoo peut être plus pratique pour les développeurs de modules car elle est plus facilement accessible que l’utilisation d’installateurs packagés.
It makes starting and stopping Odoo more flexible and explicit than the services set up by the packaged installers. Also, it allows overriding settings using without needing to edit a configuration file.
Enfin, il offre un meilleur contrôle sur la configuration du système et permet de conserver (et d’exécuter) plus facilement plusieurs versions d’Odoo côte à côte.
Récupérer les sources¶
Il existe deux manières d’obtenir le code source d’Odoo : sous forme d”archive ZIP ou via Git.
Archive¶
Edition communautaire:
Edition pour entreprise:
Git¶
Note
Il est nécessaire d’avoir Git installé, et il est recommandé d’avoir une connaissance de base des commandes Git pour continuer.
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
$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git
$ git clone [email protected]:odoo/odoo.git
$ git clone [email protected]:odoo/enterprise.git
C:\> git clone https://github.com/odoo/odoo.git
C:\> git clone https://github.com/odoo/enterprise.git
C:\> git clone [email protected]:odoo/odoo.git
C:\> git clone [email protected]:odoo/enterprise.git
$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git
$ git clone [email protected]:odoo/odoo.git
$ git clone [email protected]:odoo/enterprise.git
Note
Le référentiel git Enterprise ne contient pas le code source complet d’Odoo. Il ne s’agit que d’une collection de modules complémentaires supplémentaires. Le code du serveur principal se trouve dans l’édition Community. Exécuter la version Enterprise signifie exécuter le serveur à partir de la version Community avec l’option addons-path
définie sur le dossier avec l’édition Enterprise. Il est nécessaire de cloner les référentiels Community et Enterprise pour avoir une installation Odoo Enterprise fonctionnelle.
Préparer¶
Python¶
Odoo nécessite Python 3.7 ou version ultérieure pour fonctionner.
Utilisez un gestionnaire de packages pour télécharger et installer Python 3 si nécessaire.
Téléchargez la dernière version de Python 3 et installez-la.
Lors de l’installation, cochez Ajouter Python 3 à PATH, puis cliquez sur Personnaliser l’installation et assurez-vous que pip est coché.
Note
Si Python 3 est déjà installé, assurez-vous que la version est 3.7 ou supérieure, car les versions précédentes ne sont pas compatibles avec Odoo.
$ python3 --version
C:\> python --version
$ python3 --version
Vérifiez que pip est également installé pour cette version.
$ pip3 --version
C:\> pip --version
$ pip3 --version
PostgreSQL¶
Odoo utilise PostgreSQL comme système de gestion de base de données.
Utilisez un gestionnaire de packages pour télécharger et installer PostgreSQL (versions prises en charge : 12.0 ou supérieure). Cela peut être réalisé en exécutant ce qui suit :
$ sudo apt install postgresql postgresql-client
Téléchargez PostgreSQL (versions prises en charge : 12.0 ou supérieure) et installez-le.
Utilisez Postgres.app pour télécharger et installer PostgreSQL (version prise en charge : 12.0 ou supérieure).
Astuce
Pour rendre disponibles les outils de ligne de commande fournis avec Postgres.app, assurez-vous de configurer la variable $PATH
en suivant les instructions des outils CLI `Postgres.app <https://postgresapp.com/documentation/cli-tools.html >`_.
Par défaut, le seul utilisateur est « postgres ». Comme Odoo interdit de se connecter en tant que « postgres », créez un nouvel utilisateur PostgreSQL.
$ sudo -u postgres createuser -s $USER
$ createdb $USER
Note
L’utilisateur PostgreSQL ayant le même nom que le login Unix, il est possible de se connecter à la base de données sans mot de passe.
Ajoutez le répertoire
bin
de PostgreSQL (par défaut :C:\Program Files\PostgreSQL\<version>\bin
) auPATH
.Créez un utilisateur postgres avec un mot de passe à l’aide de l’interface graphique d’administration de pg :
Ouvrez pgAdmin.
Double-cliquez sur le serveur pour créer une connexion.
Sélectionnez
.Entrez le nom d’utilisateur dans le champ Nom du rôle (par exemple, « odoo »).
Ouvrez l’onglet Définition, saisissez un mot de passe (par exemple, « odoo ») et cliquez sur Enregistrer.
Ouvrez l’onglet Privilèges et basculez Peut se connecter ? sur « Oui » et Créer une base de données ? sur « Oui ».
$ sudo -u postgres createuser -s $USER
$ createdb $USER
Note
L’utilisateur PostgreSQL ayant le même nom que le login Unix, il est possible de se connecter à la base de données sans mot de passe.
Dépendances¶
L’utilisation de packages de distribution est la méthode privilégiée pour installer les dépendances. Vous pouvez également installer les dépendances Python avec pip.
For Debian-based systems, the packages are listed in the debian/control file of the Odoo sources.
Sur Debian/Ubuntu, les commandes suivantes doivent installer les packages requis :
$ cd /CommunityPath
$ sed -n -e '/^Depends:/,/^Pre/ s/ python3-\(.*\),/python3-\1/p' debian/control | sudo xargs apt-get install -y
Comme certains packages Python nécessitent une étape de compilation, ils nécessitent l’installation des bibliothèques système.
Sur Debian/Ubuntu, la commande suivante doit installer ces bibliothèques requises :
$ sudo apt install python3-pip libldap2-dev libpq-dev libsasl2-dev
Les dépendances Odoo sont répertoriées dans le fichier requirements.txt
situé à la racine du répertoire Odoo Community.
Note
Les packages Python dans requirements.txt
sont basés sur leur version stable/LTS Debian/Ubuntu correspondante au moment de la sortie d’Odoo. Par exemple, pour Odoo 15.0, la version du package « python3-babel » est 2.8.0 dans Debian Bullseye et 2.6.0 dans Ubuntu Focal. La version la plus basse est ensuite choisie dans le requirements.txt
.
Astuce
Il peut être préférable de ne pas mélanger les packages de modules Python entre différentes instances d’Odoo ou avec le système. Cependant, il est possible d’utiliser virtualenv pour créer des environnements Python isolés.
Accédez au chemin d’installation de la communauté Odoo (CommunityPath
) et exécutez pip sur le fichier d’exigences pour installer les exigences pour l’utilisateur actuel.
$ cd /CommunityPath
$ pip install -r requirements.txt
Avant d’installer les dépendances, téléchargez et installez les Build Tools for Visual Studio. Sélectionnez Outils de build C++ dans l’onglet Workloads et installez-les lorsque vous y êtes invité.
Les dépendances Odoo sont répertoriées dans le fichier requirements.txt
situé à la racine du répertoire de la communauté Odoo.
Astuce
Il peut être préférable de ne pas mélanger les packages de modules Python entre différentes instances d’Odoo ou avec le système. Cependant, il est possible d’utiliser virtualenv pour créer des environnements Python isolés.
Accédez au chemin d’installation de la communauté Odoo (CommunityPath
) et exécutez pip sur le fichier d’exigences dans un terminal avec les privilèges d’administrateur :
C:\> cd \CommunityPath
C:\> pip install setuptools wheel
C:\> pip install -r requirements.txt
Les dépendances Odoo sont répertoriées dans le fichier requirements.txt
situé à la racine du répertoire de la communauté Odoo.
Astuce
Il peut être préférable de ne pas mélanger les packages de modules Python entre différentes instances d’Odoo ou avec le système. Cependant, il est possible d’utiliser virtualenv pour créer des environnements Python isolés.
Accédez au chemin d’installation de la communauté Odoo (CommunityPath
) et exécutez pip sur le fichier d’exigences :
$ cd /CommunityPath
$ pip3 install setuptools wheel
$ pip3 install -r requirements.txt
Note
Pour les langues utilisant une interface de droite à gauche (comme l’arabe ou l’hébreu), le package rtlcss
est requis.
Téléchargez et installez nodejs et npm avec un gestionnaire de packages.
Installez
rtlcss
:$ sudo npm install -g rtlcss
Téléchargez et installez nodejs.
Installez
rtlcss
:C:\> npm install -g rtlcss
Modifiez la variable
PATH
de l’environnement système pour ajouter le dossier où se trouvertlcss.cmd
(généralement :C:\Users\<user>\AppData\ Itinérance\npm\
).
Avertissement
wkhtmltopdf
n’est pas installé via pip et doit être installé manuellement dans la version 0.12.5 pour qu’il soit pris en charge en-têtes et pieds de page. Consultez le wiki wkhtmltopdf pour plus de détails sur les différentes versions.
Exécuter Odoo¶
Une fois toutes les dépendances configurées, Odoo peut être lancé en exécutant « odoo-bin », l’interface de ligne de commande du serveur. Il se trouve à la racine du répertoire de la communauté Odoo.
Astuce
Pour l’édition Enterprise, ajoutez le chemin d’accès aux modules complémentaires « enterprise » à l’argument « addons-path ». Notez qu’il doit précéder les autres chemins dans addons-path
pour que les modules complémentaires soient chargés correctement.
Les configurations nécessaires courantes sont :
Utilisateur et mot de passe PostgreSQL.
Chemins d’extension personnalisés au-delà des valeurs par défaut pour charger des modules personnalisés.
Une manière typique d’exécuter le serveur serait :
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
Où CommunityPath
est le chemin d’installation de la communauté Odoo et mydb
est le nom de la base de données PostgreSQL.
C:\> cd CommunityPath/
C:\> python odoo-bin -r dbuser -w dbpassword --addons-path=addons -d mydb
Où CommunityPath
est le chemin d’installation de la communauté Odoo, dbuser
est la connexion PostgreSQL, dbpassword
est le mot de passe PostgreSQL et mydb
est le nom de la base de données PostgreSQL.
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
Où CommunityPath
est le chemin d’installation de la communauté Odoo et mydb
est le nom de la base de données PostgreSQL.
Une fois le serveur démarré (le journal INFO odoo.modules.loading : Modules chargés.
est imprimé), ouvrez http://localhost:8069 dans un navigateur Web et connectez-vous à la base de données Odoo avec le compte administrateur de base : utilisez ` admin` comme e-mail et, encore une fois, admin
comme mot de passe.