# HUB FRATE — Notice Locale

Bienvenue sur le HUB FRATE.

Ce dossier local a pour but de fournir une aide rapide directement sur la machine, sans dépendre du site web ni de la documentation complète d'administration.

---

## 1. Rôle du HUB

Le HUB est une appliance locale de services sécurisés.

Fonctions principales :
- Client WireGuard relié au VPS central
- Services Docker locaux
- Pi-hole (DNS filtré)
- Nginx Proxy Manager (Reverse proxy / Interfaces admin)
- Scripts d'exploitation locale
- Remontée d'état (Heartbeat) vers le Control Plane

*Note : L'administration du HUB se fait normalement à distance via le réseau WireGuard.*

---

## 2. Emplacements importants

**Runtime principal :**
```bash
/opt/hub/
```

**Docker Compose Core :**
```bash
/opt/hub/core/compose/core/docker-compose.yml
```

**Variables et état système :**
```bash
/opt/hub/state/
```

**Scripts d'exploitation utiles :**
```bash
/opt/hub/scripts/
```

---

## 3. Services attendus

Le HUB doit normalement faire tourner au minimum les conteneurs suivants :
- `pihole`
- `npm`

Les interfaces d'administration sont accessibles via l'IP WireGuard du HUB. Exemples typiques :
- **NPM :** `http://IP_WG_HUB:81`
- **Pi-hole :** `http://IP_WG_HUB:8053`

---

## 4. Vérifications de base

**Vérifier le VPN :**
```bash
sudo wg
ip a show wg0
```

**Vérifier les conteneurs :**
```bash
docker compose -f /opt/hub/core/compose/core/docker-compose.yml ps
```

**Vérifier le statut local du hub :**
```bash
/opt/hub/scripts/hub_status.sh
```

---

## 5. En cas de problème

Veuillez consulter les fichiers suivants présents dans ce répertoire :
- `RECOVERY.md` : Guide de dépannage rapide
- `COMMANDS.md` : Référence des commandes d'exploitation

*Si le HUB a encore accès au VPS via WireGuard, l'administrateur peut également vérifier le monitoring central depuis le VPS.*

---