# Installation complète de Glances Web avec pipx (Debian 12 / Proxmox) Ce guide installe **Glances 4.x (FastAPI Web UI)** proprement avec **pipx**, sans casser Python système (PEP 668). Compatible **Debian 12 / Proxmox**, CLI only. --- ## 1. Prérequis système ```bash apt update apt install -y python3 python3-venv python3-full pipx ``` Activer pipx dans le PATH : ```bash pipx ensurepath export PATH=$PATH:/root/.local/bin ``` --- ## 2. Installation de Glances via pipx ```bash pipx install glances ``` Vérification : ```bash which glances glances --version ``` Résultat attendu : ``` /root/.local/bin/glances Glances 4.x.x ``` --- ## 3. Installer les dépendances Web (OBLIGATOIRE) Glances 4.x utilise **FastAPI** pour le mode Web. ```bash pipx inject glances fastapi uvicorn ``` Vérifier : ```bash pipx list ``` --- ## 4. Test manuel du Web ```bash glances -w -B 0.0.0.0 ``` Accès : ``` http://IP_DU_SERVEUR:61208 ``` --- ## 5. Configuration Glances (custom) Créer le dossier : ```bash mkdir -p /root/.config/glances nano /root/.config/glances/glances.conf ``` Exemple de configuration : ```ini [global] refresh=2 check_update=false [cpu] hide=false [mem] hide=false [disk] hide=false [diskio] hide=false [network] hide=false [docker] hide=false ``` --- ## 6. Service systemd (démarrage automatique) Créer le service : ```bash nano /etc/systemd/system/glances-web.service ``` Contenu : ```ini [Unit] Description=Glances Web (pipx) After=network.target [Service] Type=simple User=root Environment=HOME=/root Environment=PATH=/root/.local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin ExecStart=/root/.local/bin/glances -w -B 0.0.0.0 Restart=on-failure RestartSec=3 [Install] WantedBy=multi-user.target ``` Activer : ```bash systemctl daemon-reload systemctl enable --now glances-web ``` Vérifier : ```bash systemctl status glances-web ``` --- ## 7. Dépannage rapide ### Erreur FastAPI ```bash pipx inject glances fastapi uvicorn ``` ### Port déjà utilisé ```bash ss -lntp | grep 61208 ``` Changer le port si besoin : ```ini ExecStart=/root/.local/bin/glances -w -B 0.0.0.0 -p 61209 ``` --- ## 8. Bonnes pratiques - ❌ Ne jamais utiliser `pip install glances` - ❌ Ne jamais utiliser `--break-system-packages` - ✅ pipx ou Docker uniquement - ⭐ Docker recommandé en PROD --- ## 9. Accès final ``` http://IP_DU_SERVEUR:61208 ``` --- FIN.