# 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.