{{tag>software application inventaire gestion}}


====== InvenTree ======

InvenTree est un logiciel de gestion d'inventaire open source s'appuyant sur Python et le framework Django.


===== Installation =====

:TODO_DOCUPDATE:

Un script d'installation automatise toute la procédure pour les systèmes Debian 10, 11, 12 et Ubuntu 20.04 LTS, 22.04 LTS, 24.04 LTS. Dans les autres cas, il faudra procéder à l' installation manuellement.

Installer les prérequis :

Il est fortement recommandé de ne pas exécuter le serveur InvenTree en tant que root. On crée un utilisateur avec des droits restreints pour l'installation et l'exécution de l'application

<code bash>
useradd -m -d /home/inventree -s /bin/bash inventree
</code>

==== Base de données PostgreSQL ====

Inventree peut s'appuyer indifféremment sur Postgresql ou Mariadb. Ici on a fait le choix d'utiliser PostgreSQL :

<code bash>
apt-get install -y postgresql postgresql-contrib libpq-dev
</code>

Vérifier que le serveur de base de données s'exécute bien
<code bash>
systemctl status postgresql.service
</code>


Créer une nouvelle base et un rôle : ils seront utilisés par l'application.

<code bash>
runuser -u postgres -- psql
</code>

<code sql>
CREATE DATABASE inventree;
CREATE USER itree WITH ENCRYPTED PASSWORD 'myPassW0RD';
GRANT ALL ON DATABASE inventree TO itree;

; WARN : Pour que toutes les requêtes puissent s'exécuter correctement,
;        faire de l'utilisateur le possesseur de la base;
ALTER DATABASE inventree OWNER TO itree;
</code>

Quitter le client psql. Depuis le compte root, vérifier que la base est accessible pour l'utilisateur inventree :

<code bash>
runuser -u inventree -- psql --user itree --password -h /var/run/postgresql inventree
</code>

Sur une installation par défaut, la commande précédente devrait retourner un message d'erreur du type :

<file>
psql: erreur : la connexion au serveur sur le socket « /var/run/postgresql/.s.PGSQL.5432 » a échoué : FATAL:  authentification peer échouée pour l'utilisateur « itree »
</file>

A l'installation, le serveur PostgreSQL est paramétré pour n'autoriser les utilisateurs locaux à se connecter à la socket qu' en mode "peer".

Modifier le fichier d'autorisation ''/etc/postgresql/17/main/pg_hba.conf'' pour permettre une connexion par role/mot de passe sur la base inventree  : 

<file conf [highlight_lines_extra="8"]>
# ...
# Database administrative login by Unix domain socket
local   all             postgres                                peer

# TYPE  DATABASE        USER            ADDRESS                 METHOD

# "local" is for Unix domain socket connections only
local   inventree       itree                                   password
local   all             all                                     peer
# ...
</file>

<note>
Attention à la position de la ligne dans le fichier : placer les connexions rôle/mot de passe avant la ligne ''all all peer'' (évaluation séquentielle et sortie à la première correspondance).
</note>

<code bash>
systemctl reload postgresql.service
runuser -u inventree -- psql --user itree --password -h /var/run/postgresql inventree
</code>

Si tout est correctement paramétré, le client psql est connecté au serveur et affiche le nom de la base dans le prompt
<file>
psql (17.8 (Debian 17.8-0+deb13u1))
Saisissez « help » pour l'aide.

inventree=>
</file>


==== Application ====

Installer les paquetages prérequis :

<code bash>
apt-get update
apt-get install -y \
    python3 python3-dev python3-pip python3-invoke python3-venv \
    git gcc g++ gettext gnupg \
    poppler-utils libpango-1.0-0 libpangoft2-1.0-0 \
    libjpeg-dev webp
    
apt install -y weasyprint
</code>


<code bash>
# Création des répertoires nécessaires à l'application
mkdir -p /srv/inventree/data/{static,media,backup}
chown -R inventree: /srv/inventree

su - inventree
cd /srv/inventree
</code>

Récupérer le code source d'InvenTree :

<code bash>
# git clone https://github.com/inventree/inventree src
git clone https://github.com/inventree/inventree app
</code>

La branche ''master'' intègre les dernières fonctionnalités mais est en cours de développement. Utiliser la branche stable de préférence puis créer l'environnement virtuel Python :

<code bash>
cd app
git checkout stable

python3 -m venv env
source env/bin/activate

# Les paquets requis pour le serveur InvenTree doivent être installés dans l'environnement virtuel
pip install --upgrade --ignore-installed invoke

# Selon le SGDB choisit, installer paquets de liaison binding (ici PostgreSQL)
pip3 install psycopg pgcli

# Si MySQL
# pip3 install mysqlclient mariadb

# Installer
export INVENTREE_SITE_URL="http://inventree.kvm.internal"
export INVENTREE_STATIC_ROOT="/srv/inventree/data/static/"
export INVENTREE_MEDIA_ROOT="/srv/inventree/data/media/"
export INVENTREE_BACKUP_DIR="/srv/inventree/data/backup/"
export INVENTREE_DB_ENGINE=postgresql
export INVENTREE_DB_NAME=inventree INVENTREE_DB_USER=itree INVENTREE_DB_PASSWORD="myPassW0RD"

invoke install
</code>

Initialiser la base de données :

<code bash>
invoke update --skip-backup
</code>

Créer le compte d'administration
<code bash>
invoke superuser
</code>

Tester l'installation avec le serveur de développement :
<code bash>
invoke dev.server
</code>

Ouvrir le navigateur à l'adresse ''http://your-vm-ip:8000''

===== Construire le frontend =====

<code bash>
apt install -y yarnpkg
</code>

===== Références =====

  * [[https://docs.inventree.org/en/stable/|Documentation officielle InvenTree (docs.inventree.org) (en)]]
  * [[https://docs.inventree.org/en/stable/start/install/|Guides d'installation d'InvenTree (inventree.org) (en)]]
  * [[https://docs.inventree.org/en/stable/start/bare_prod/|Installer un serveur de production (docs.inventree.org) (en)]]
  * [[https://linuxcapable.com/how-to-install-yarn-on-debian-linux/|Installer yarn sur Debian (linuxcapable.com) (en)]]