Cet article couvre l'installation depuis les sources (git clone). C'est la méthode recommandée pour le développement, car elle te donne un contrôle total sur le code et te permet de travailler sur plusieurs versions en parallèle grâce aux environnements virtuels Python.

Étape 1 — Mettre à jour le système et installer les dépendances

Commence par mettre à jour la liste des paquets et installer les mises à jour de sécurité :

sudo apt update && sudo apt upgrade -y

Ensuite, installe les paquets système nécessaires à la compilation des dépendances Python d'Odoo. Cette commande couvre toutes les librairies requises :

sudo apt install -y git python3-dev python3-pip python3-venv \
    build-essential libxml2-dev libxslt1-dev libldap2-dev libsasl2-dev \
    libpq-dev libjpeg-dev libfreetype6-dev libtiff5-dev libopenjp2-7-dev \
    liblcms2-dev libwebp-dev libharfbuzz-dev libfribidi-dev libxcb1-dev \
    zlib1g-dev node-less npm

Si ton application doit supporter les langues écrites de droite à gauche (arabe, hébreu), installe également rtlcss :

sudo npm install -g rtlcss

Étape 2 — Installer et configurer PostgreSQL 16

Odoo utilise exclusivement PostgreSQL comme système de gestion de base de données. Ubuntu 24.04 embarque PostgreSQL 16 par défaut :

sudo apt install -y postgresql postgresql-client

Vérifie que le service est actif :

sudo systemctl status postgresql

Tu devrais voir active (exited) — c'est normal, PostgreSQL est géré par pg_ctlcluster en arrière-plan.

Crée maintenant un utilisateur PostgreSQL dédié à Odoo. Son nom doit correspondre à l'utilisateur système que l'on va créer à l'étape 4 :

sudo -u postgres createuser -d -R -S odoo19

Étape 4 — Créer un utilisateur système dédié

Pour des raisons de sécurité, Odoo ne doit jamais tourner sous root ni sous ton compte utilisateur personnel. On crée un utilisateur système dédié :

sudo useradd -m -d /opt/odoo19 -U -r -s /bin/bash odoo19

Cet utilisateur possède son propre répertoire /opt/odoo19 où l'on va stocker les sources Odoo, l'environnement virtuel et les modules custom.

Étape 5 — Télécharger Odoo 19 et créer l'environnement virtuel

Bascule sur l'utilisateur odoo19 pour que tous les fichiers appartiennent au bon propriétaire :

sudo su - odoo19

Clone le dépôt officiel Odoo 19 Community depuis GitHub :

git clone https://github.com/odoo/odoo.git --depth 1 --branch 19.0 --single-branch /opt/odoo19/odoo

Crée l'environnement virtuel Python :

python3 -m venv /opt/odoo19/venv

Active l'environnement virtuel et installe les dépendances :

source /opt/odoo19/venv/bin/activate
pip install wheel
pip install -r /opt/odoo19/odoo/requirements.txt

L'installation pip peut prendre 2 à 5 minutes selon ta connexion. Certains paquets compilent du code C (lxml, Pillow, psycopg2) — c'est pour cela qu'on a installé les paquets -dev à l'étape 1.

Crée un répertoire pour tes futurs modules custom :

mkdir /opt/odoo19/custom-addons

Quitte l'utilisateur odoo19 :

deactivate
exit

Étape 7 — Premier lancement manuel

Avant de créer le service systemd, vérifie que tout fonctionne en lançant Odoo manuellement :

sudo -u odoo19 /opt/odoo19/venv/bin/python3 /opt/odoo19/odoo/odoo-bin -c /etc/odoo19.conf

Tu devrais voir les logs défiler dans le terminal. Quand la ligne suivante apparaît, Odoo est prêt :

INFO ? odoo.modules.loading: Modules loaded.

Ouvre ton navigateur à l'adresse http://localhost:8069 (ou http://IP_DU_SERVEUR:8069 si tu es sur un serveur distant).

La page de création de base de données s'affiche. Remplis les champs :

• Master Password : le mot de passe défini dans admin_passwd
• Database Name : le nom de ta base (ex : odoo19_dev)
• Email : ton adresse email (sera le login admin)
• Password : mot de passe de l'utilisateur admin
• Language : Français
• Country : ton pays

Clique sur Create Database. Après quelques secondes, tu arrives sur la page d'accueil d'Odoo avec la liste des applications à installer.

Arrête le processus avec Ctrl+C une fois le test réussi.

Étape 8 — Créer un service systemd

Pour que Odoo démarre automatiquement au boot du serveur, crée un fichier service :

sudo nano /etc/systemd/system/odoo19.service

Colle le contenu suivant :

[Unit]
Description=Odoo 19
Requires=postgresql.service
After=network.target postgresql.service

[Service]
Type=simple
SyslogIdentifier=odoo19
User=odoo19
Group=odoo19
ExecStart=/opt/odoo19/venv/bin/python3 /opt/odoo19/odoo/odoo-bin -c /etc/odoo19.conf
StandardOutput=journal+console

[Install]
WantedBy=multi-user.target

Active et démarre le service :

sudo systemctl daemon-reload
sudo systemctl enable --now odoo19

Vérifie que le service tourne :

sudo systemctl status odoo19

Tu devrais voir active (running). Voici les commandes utiles pour gérer le service au quotidien :

# Arrêter Odoo
sudo systemctl stop odoo19

# Démarrer Odoo
sudo systemctl start odoo19

# Redémarrer Odoo (après modification de code ou config)
sudo systemctl restart odoo19

# Consulter les logs en temps réel
sudo journalctl -u odoo19 -f

Récapitulatif

Voici la checklist complète de ce que tu as mis en place :

Structure finale des répertoires

/opt/odoo19/
├── odoo/                  # Sources Odoo 19 (git clone)
│   ├── addons/            # Modules officiels
│   ├── odoo/              # Framework Python
│   ├── odoo-bin           # Point d'entrée
│   └── requirements.txt   # Dépendances pip
├── venv/                  # Environnement virtuel Python
│   ├── bin/python3
│   └── lib/
└── custom-addons/         # Tes modules personnalisés

/etc/odoo19.conf           # Configuration Odoo
/etc/systemd/system/odoo19.service  # Service systemd
/var/log/odoo19/odoo.log   # Fichier de log