Initial vault setup

2026-06-09 18:40:21 +02:00
commit bda02d587f
3692 changed files with 402457 additions and 0 deletions
@@ -0,0 +1,179 @@
+---
+title: LogForge
+created: 2026-06-07
+updated: 2026-06-07
+type: app
+tags: [catalogue, logs, monitoring, docker, services, dashboard, go, status, ressources]
+confidence: high
+contested: false
+sources: [https://selfh.st/apps/?tag=Logs, https://github.com/log-forge/logforge]
+---
+
+# 📋 LogForge
+
+> **Le dashboard de monitoring pour services Docker** : visualisez le status, les logs, l'usage CPU/RAM et contrôlez le cycle de vie de vos containers depuis une seule UI. Le compagnon idéal du docker-compose.
+
+## 📋 Informations Générales
+
+| Champ | Valeur |
+| :--- | :--- |
+| **Site web** | [github.com/log-forge/logforge](https://github.com/log-forge/logforge) |
+| **GitHub** | [log-forge/logforge](https://github.com/log-forge/logforge) |
+| **License** | MIT |
+| **Langage** | Go |
+| **Étoiles GitHub** | 291 ⭐ |
+| **Dernière MAJ** | 2026-05-20 |
+| **Catégorie** | [[cat-logs|Logs]] |
+
+## 📝 Description
+
+**LogForge** est un **dashboard de monitoring** léger pour **services Docker** qui combine visualisation de logs, status de santé, métriques de ressources (CPU/RAM/disk) et **actions de cycle de vie** (start/stop/restart) dans une seule UI. C'est l'outil idéal pour les petits/moyens labos qui veulent **gérer visuellement** leurs containers sans se prendre la tête avec la CLI Docker.
+
+L'idée est simple : LogForge lit votre socket Docker (ou l'API Docker), liste tous les containers, affiche leur status, **stream les logs en temps réel**, montre leur consommation de ressources, et permet de les **contrôler** (start, stop, restart). Pas de base de données externe, pas d'agent, juste un binaire Go unique qui parle à Docker.
+
+LogForge se distingue de [[app-dozzle]] (logs only) en ajoutant le **monitoring ressources** et le **contrôle de cycle de vie**. C'est un "mini Portainer" minimaliste en Go, parfait pour les labos persos.
+
+**Public cible** : développeurs qui gèrent un labo Docker sur un NAS/VPS, sysadmins qui veulent un dashboard léger sans Portainer/Rancher, amateurs d'auto-hébergement qui veulent visualiser leurs containers.
+
+- ✅ **UI unifiée** : status + logs + métriques + actions
+- ✅ **Logs streaming temps réel** : WebSocket vers Docker
+- ✅ **Métriques CPU/RAM/Disk** par container
+- ✅ **Actions start/stop/restart** directement depuis l'UI
+- ✅ **Single binary** Go : ~20 Mo de RAM
+- ✅ **Docker socket** ou API TCP (remote Docker hosts)
+- ✅ **Configuration simple** : un fichier YAML
+- ✅ **MIT License** : usage libre
+- ✅ **Multi-host** : possible de monitorer plusieurs Docker daemons
+- ✅ **Thèmes clair/sombre** : UI moderne
+- ⚠️ **Docker only** : ne gère pas K8s, LXC, etc.
+- ⚠️ **Communauté modeste** (291 ⭐) : peu de retours à grande échelle
+
+## 🚀 Installation
+
+### Option 1 : Docker (recommandé)
+
+```yaml
+# docker-compose.yml
+version: '3.8'
+services:
+  logforge:
+    image: ghcr.io/log-forge/logforge:latest
+    container_name: logforge
+    restart: unless-stopped
+    environment:
+      DOCKER_HOST: unix:///var/run/docker.sock
+      LOG_LEVEL: info
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock:ro
+    ports:
+      - "9090:9090"
+    labels:
+      - "traefik.enable=true"
+      - "traefik.http.routers.logforge.rule=Host(`logforge.example.com`)"
+      - "traefik.http.routers.logforge.entrypoints=websecure"
+      - "traefik.http.routers.logforge.tls.certresolver=letsencrypt"
+```
+
+### Option 2 : Single binary
+
+```bash
+curl -L https://github.com/log-forge/logforge/releases/latest/download/logforge-linux-amd64 -o logforge
+chmod +x logforge
+./logforge --config config.yaml
+```
+
+### Option 3 : Docker socket proxy (plus sûr)
+
+```yaml
+# Utiliser [[app-dozzle]] ou un proxy pour exposer le socket de manière sécurisée
+# LogForge + socket proxy = plus sûr que monter le socket direct
+services:
+  socket-proxy:
+    image: tecnativa/docker-socket-proxy
+    environment:
+      CONTAINERS: 1
+      IMAGES: 1
+      NETWORKS: 0
+      VOLUMES: 0
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock:ro
+
+  logforge:
+    image: ghcr.io/log-forge/logforge:latest
+    depends_on:
+      - socket-proxy
+    environment:
+      DOCKER_HOST: tcp://socket-proxy:2375
+```
+
+## ⚙️ Configuration Initiale
+
+1. **Monter le socket Docker** : voir docker-compose ci-dessus
+2. **Lancer LogForge** : `docker compose up -d`
+3. **Accéder à l'UI** : `http://IP:9090`
+4. **Voir les containers** : page d'accueil liste tous les containers (running/stopped)
+5. **Cliquer sur un container** : voir ses logs en temps réel
+6. **Actions rapides** : boutons start/stop/restart dans l'UI
+7. **Métriques** : graphiques CPU/RAM par container
+8. **Ajouter un hôte distant** : `config.yaml` > `docker_hosts`
+9. **Activer l'auth** : basic auth (ou via reverse proxy)
+
+## 🔄 Alternatives
+
+### Open Source
+- [[app-dozzle]] — Logs Docker only (très populaire)
+- **Portainer** — Le grand du genre (plus complet mais plus lourd)
+- **Yacht** — UI moderne pour Docker (TypeScript)
+- **Dockge** — Compose-focused UI (Fireship)
+- **Lazydocker** — TUI Docker (terminal)
+- **cAdvisor** — Métriques containers Google
+
+### Comparaison LogForge vs autres
+
+| Critère | LogForge | Dozzle | Portainer | Lazydocker |
+| :--- | :--- | :--- | :--- | :--- |
+| **Logs** | ✅ | ✅✅ | ✅ | ✅ |
+| **Métriques** | ✅ CPU/RAM/Disk | ❌ | ✅ | ✅ |
+| **Actions** | ✅ start/stop | ❌ | ✅✅ Tout | ✅ |
+| **Multi-host** | ✅ | ❌ | ✅ | ❌ |
+| **UI** | Web | Web | Web | TUI |
+| **RAM** | ~20 Mo | ~30 Mo | ~100 Mo | ~30 Mo |
+| **Setup** | 2 min | 1 min | 5 min | 1 min |
+| **License** | MIT | MIT | Zlib (CE) | MIT |
+| **Stars** | 291 | 13k | 30k+ | 50k+ |
+
+**Verdict** : LogForge est **un bon compromis** entre Dozzle (logs only) et Portainer (lourd). Si vous voulez juste les logs, [[app-dozzle]] est mieux. Si vous voulez tout gérer, Portainer. Si vous voulez un dashboard léger avec actions, LogForge est idéal.
+
+### Propriétaires (ce que LogForge remplace)
+- **Docker Dashboard** (Docker Desktop, pas self-hosted)
+- **Portainer Business Edition** (payante)
+- **Rancher** (peut être lourd)
+- **Sysdig** (monitoring Docker, cher)
+- **Datadog Container Monitoring** (cher)
+
+## 🔐 Sécurité
+
+- ⚠️ **Logs = données sensibles** : logs Docker contiennent souvent des secrets
+- ✅ **Chiffrement in-transit** : TLS obligatoire (Traefik en reverse proxy)
+- ✅ **Authentification** : basic auth ou SSO via reverse proxy
+- ⚠️ **Docker socket** : **TRÈS DANGEREUX** si monté tel quel (accès root) — utiliser un socket proxy
+- ✅ **Read-only socket** : monter `:ro` pour limiter les dégâts
+- ✅ **RBAC limité** : ne pas exposer publiquement sans auth
+- ⚠️ **Rétention** : aucune (LogForge stream juste les logs live)
+- ✅ **Pas de stockage** : aucune DB à compromettre
+- ✅ **Pas de backup nécessaire** : stateless
+- ✅ **Logs éphémères** : parfaits pour RGPD (pas de conservation)
+
+## 📚 Ressources
+
+- [GitHub log-forge/logforge](https://github.com/log-forge/logforge)
+- [Documentation officielle](https://github.com/log-forge/logforge#readme)
+- [Docker Socket Proxy (sécurité)](https://github.com/Tecnativa/docker-socket-proxy)
+- [Tutoriels vidéo](https://github.com/log-forge/logforge/wiki)
+
+## Pages Liées
+
+- [[cat-logs]] — Catégorie Logs
+- [[app-uptime-kuma]] — Monitoring uptime (complémentaire)
+- [[app-loki]] — Pour archivage long terme des logs Docker
+- [[securisation-home-lab]] — Bonnes pratiques sécurité