Installation par la 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 d’Odoo peut être plus pratique pour les développeurs de modules, car elle est plus facilement accessible que l’utilisateur de programmes d’installation.

Elle rend le démarrage et l’arrêt d’Odoo plus flexibles et plus explicites que les services configurés par les programmes d’installation. De plus, elle permet d’outrepasser les paramètres en utilisant des paramètres de ligne de commande sans avoir à éditer un fichier de configuration.

Enfin, elle offre un plus grand 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 y a deux façons d’obtenir le code source d’Odoo : sous forme d”archive ZIP ou via Git :

Archiver¶

Édition Community :

Édition Enterprise :

Git¶

Note

Vous devez d’abord installer Git et il est recommandé d’avoir une connaissance de base des commandes Git pour continuer.

Pour cloner un dépôt Git, choisir entre le clonage avec HTTPS ou SSH. Dans la plupart des cas, la meilleure option est HTTPS. Cependant, choisir SSH pour contribuer au code source d’Odoo ou lors du suivi du tutoriel développeur de démarrage.

$ git clone --branch 19.0 --single-branch https://github.com/odoo/odoo.git
$ git clone --branch 19.0 --single-branch https://github.com/odoo/enterprise.git

$ git clone --branch 19.0 --single-branch git@github.com:odoo/odoo.git
$ git clone --branch 19.0 --single-branch git@github.com:odoo/enterprise.git

C:\> git clone --branch 19.0 --single-branch https://github.com/odoo/odoo.git
C:\> git clone --branch 19.0 --single-branch https://github.com/odoo/enterprise.git

C:\> git clone --branch 19.0 --single-branch git@github.com:odoo/odoo.git
C:\> git clone --branch 19.0 --single-branch git@github.com:odoo/enterprise.git

$ git clone --branch 19.0 --single-branch https://github.com/odoo/odoo.git
$ git clone --branch 19.0 --single-branch https://github.com/odoo/enterprise.git

$ git clone --branch 19.0 --single-branch git@github.com:odoo/odoo.git
$ git clone --branch 19.0 --single-branch git@github.com:odoo/enterprise.git

Note

Le dépôt Enterprise git ne contient pas l’intégralité du code source d’Odoo. Il ne s’agit que d’une collection de modules complémentaires. Le code principal du serveur se trouve dans la version Community. Exécuter la version Enterprise signifie exécuter le serveur à partir de la version Community avec l’option addons-path configurée sur le dossier contenant la version Enterprise. Vous devez cloner à la fois les dépôts Community et Enterprise pour avoir une installation Odoo Enterprise qui fonctionne.

Préparer¶

Python¶

Odoo requiert Python 3.10 ou une version plus récente pour fonctionner.

Modifié dans la version 17: La configuration minimale requise est passée de Python 3.7 à Python 3.10.

Utilisez un gestionnaire de paquets pour télécharger et installer Python 3 si nécessaire.

Note

Si Python 3 est déjà installé, s’assurer que la version est 3.10 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 en tant que système de gestion de base de données.

Modifié dans la version 19: Exigence minimale mise à jour de PostgreSQL 12 à PostgreSQL 13.

Utiliser un gestionnaire de paquets pour télécharger et installer PostgreSQL (versions prises en charge : 13.0 ou supérieure). Cela peut être réalisé en exécutant ce qui suit :

$ sudo apt install postgresql postgresql-client

Utiliser Postgres.app pour télécharger et installer PostgreSQL (version prise en charge : 13.0 ou supérieure).

Astuce

Pour que les outils de ligne de commande fournis avec Postgres.app soient disponibles, assurez-vous de configurer la variable $PATH en suivant les instructions relatives aux outils CLI de Postgres.app.

Par défaut, le seul utilisateur est postgres. Comme Odoo ne permet pas de se connecter en tant que postgres, créez un nouvel utilisateur PostgreSQL.

$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER

Note

L’utilisateur PostgreSQL ayant le même nom que l’identifiant Unix, il est possible de se connecter à la base de données sans mot de passe.

Ajoutez le dépôt bin de PostgreSQL (par défaut : C:\Program Files\PostgreSQL\<version>\bin) au PATH.
Créez un utilisateur postgres avec un mot de passe en utilisant le guide pg admin :
1. Ouvrez pgAdmin.
2. Double-cliquez sur le serveur pour créer une connexion.
3. Sélectionnez Objet ‣ Créer ‣ Rôle Login/Groupe.
4. Saisissez le nom d’utilisateur dans le champ Nom de rôle (par ex. odoo).
5. Ouvrez l’onglet Définition, saisissez un mot de passe (par ex. odoo), et cliquez sur Enregistrer.
6. Ouvrez l’onglet Privilèges et définissez Peut se connecter ? sur Oui et Créer une base de données ? sur Oui.

$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER

Note

L’utilisateur PostgreSQL ayant le même nom que l’identifiant Unix, il est possible de se connecter à la base de données sans mot de passe.

Note

Si vous souhaitez utiliser les fonctionnalités IA d’Odoo, l’extension PostgreSQL pg-vector est requise.

Notez que pg-vector est disponible uniquement pour PostgreSQL version 15 et supérieure.

Accéder à votre dossier temporaire
```
$ cd /tmp
```

Cloner le dépôt GitHub pg-vector :

$ git clone https://github.com/pgvector/pgvector.git

Accéder au répertoire :
```
$ cd pgvector
```
Compiler l’extension :
```
$ make
```
Installer l’extension :
```
$ sudo make install
```

Si vous rencontrez des problèmes lors de l’installation, assurez-vous de consulter les notes d’installation officielles.

Accéder à votre dossier temporaire
```
$ cd /tmp
```

Cloner le dépôt GitHub pg-vector :

$ git clone https://github.com/pgvector/pgvector.git

Accéder au répertoire :
```
$ cd pgvector
```
Compiler l’extension :
```
$ make
```
Installer l’extension :
```
$ sudo make install
```

Si vous rencontrez des problèmes lors de l’installation, assurez-vous de consulter les notes d’installation officielles.

Accéder à votre dossier temporaire
```
$ cd %TEMP%
```

Cloner le dépôt GitHub pg-vector :

$ git clone https://github.com/pgvector/pgvector.git

Accéder au répertoire :
```
$ cd pgvector
```
Assurez-vous que le support C++ dans Visual Studio est installé et exécutez x64 Native Tools Command Prompt for VS [version] en tant qu’administrateur.

Définir votre variable d’environnement PGROOT :

$ set "PGROOT=C:\Program Files\PostgreSQL\[Your PostgreSQL Version]"

Compiler l’extension :
```
$ nmake /F Makefile.win
```
Installer l’extension :
```
$ nmake /F Makefile.win install
```

Si vous rencontrez des problèmes lors de l’installation, assurez-vous de consulter les notes d’installation officielles.

Dépendances¶

L’utilisation des packages de distribution est la méthode préférée d’installer les dépendances. Il est également possible d’installer les dépendances Python avec pip.

Sur Debian/Ubuntu, les commandes suivantes doivent installer les packages suivants :

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

Le script setup/debinstall.sh analysera le fichier debian/control et installera les paquets trouvés.

Avertissement

Utiliser pip peut entraîner des problèmes de sécurité et des dépendances cassées ; ne faire cela que si vous savez ce que vous faites.

Comme certains packages Python nécessitent une étape de compilation, ils requièrent l’installation d’un système de gestion de bibliothèque.

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 publication 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 alors choisie dans le fichier requirements.txt.

Astuce

Il peut être préférable de ne pas mélanger les packages de modules Python entre les 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.

Allez jusqu’au chemin de l’installation Odoo Community (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 Outils de développement pour Visual Studio. Sélectionnez outils de développement C++ dans l’onglet Charges de travail et installez-les lorsque vous y êtes invité.

Les dépendances d’Odoo sont répertoriées dans le fichier requirements.txt situé à la racine du répertoire d’Odoo Community.

Astuce
Il peut être préférable de ne pas mélanger les packages de modules Python entre les 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.

Allez jusqu’au chemin de l’installation Odoo Community (CommunityPath) et exécutez pip sur le fichier d’exigences dans un terminal avec privilèges d’administrateur :

C:\> cd \CommunityPath
C:\> pip install setuptools wheel
C:\> pip install -r requirements.txt

Les dépendances d’Odoo sont répertoriées dans le fichier requirements.txt situé à la racine du répertoire d’Odoo Community.

Astuce
Il peut être préférable de ne pas mélanger les packages de modules Python entre les 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.

Allez jusqu’au chemin de l’installation Odoo Community (CommunityPath) et exécutez pip sur le fichier d’exigences :

$ cd /CommunityPath
$ pip3 install setuptools wheel
$ pip3 install -r requirements.txt

Avertissement

Les dépendances non Python doivent être installées à l’aide d’un gestionnaire de paquets (Homebrew, MacPorts).

Téléchargez et installez les Outils de ligne de commande :
```
$ xcode-select --install
```
Utilisez le gestionnaire de paquets pour installer des dépendances non Python.

Note

Pour les langues utilisant une interface de droite à gauche (telle que l’arabe ou l’hébreu), le package rtlcss est requis.

Téléchargez et installez nodejs et npm à l’aide d’un gestionnaire de paquets.
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 fichier où se trouve rtlcss.cmd (généralement : C:\Users\<user>\AppData\Roaming\npm\).

Téléchargez et installez nodejs à l’aide d’un gestionnaire de paquets (Homebrew, MacPorts).
Installez rtlcss :
```
$ sudo npm install -g rtlcss
```

Avertissement

wkhtmltopdf n’est pas installé par pip et doit être installé manuellement dans la version 0.12.6 pour qu’il prenne en charge les en-têtes et les pieds de page. Consultez la wkhtmltopdf wiki pour plus de détails sur les différentes versions.

Exécuter Odoo¶

Une fois que toutes les dépendances sont installées, Odoo peut être lancé en exécutant odoo-bin, l’interface en ligne de commande du serveur. Elle se situe à la racine du répertoire Odoo Community.

Pour configurer le serveur, vous pouvez définir des arguments de ligne de commande ou un fichier de configuration.

Astuce

Pour l’édition Enterprise, ajoutez le chemin vers les 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 les plus courantes sont les suivantes :

Utilisateur et mot de passe PostgreSQL.
Chemins d’accès personnalisés au-delà des chemins par défaut pour charger vos propres modules.

Une façon typique d’exécuter le serveur serait :

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

Où CommunityPath est le chemin de l’installation Odoo Community 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 de l’installation Odoo Community, dbuser est le login 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 de l’installation Odoo Community et mydb est le nom de la base de données PostgreSQL.

Une fois que le serveur a démarré (le journal INFO odoo.modules.loading: Modules loaded. 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 adresse e-mail et, à nouveau, admin comme mot de passe.

Astuce

À partir de là, créer et gérer de nouveaux utilisateurs.
Le compte utilisateur utilisé pour vous connecter à l’interface web d’Odoo diffère de l’argument CLI --db_user.

Voir également

La liste des arguments CLI pour odoo-bin

Modifier sur GitHub