Auto-sync Tue 13 Jan 16:00:01 CET 2026

2026-01-13 16:00:01 +01:00
parent 008421a344
commit ee538cbc50
3 changed files with 284 additions and 0 deletions
--- a/docs/services/homarr.md
+++ b/docs/services/homarr.md
@@ -0,0 +1,145 @@
+# Homarr
+
+Dashboard self-hosted pour organiser et accéder aux services homelab.
+
+## Présentation
+
+Homarr est un dashboard moderne pour centraliser l'accès à tous les services. Intégration native avec les *arr apps, widgets temps réel, personnalisation poussée.
+
+!!! info "Projet"
+    [GitHub Homarr](https://github.com/ajnart/homarr) — Open source, MIT License
+
+## Déploiement
+
+### Docker Compose
+
+Créer `~/lake/tools/homarr/docker-compose.yml` :
+
+```yaml
+services:
+  homarr:
+    image: ghcr.io/ajnart/homarr:latest
+    container_name: homarr
+    restart: unless-stopped
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock:ro
+      - ./configs:/app/data/configs
+      - ./icons:/app/public/icons
+      - ./data:/data
+    ports:
+      - "7575:7575"
+    environment:
+      - TZ=Europe/Luxembourg
+    networks:
+      - lake_net
+
+networks:
+  lake_net:
+    external: true
+```
+
+### Démarrage
+
+```bash
+cd ~/lake/tools/homarr
+docker compose up -d
+```
+
+### Caddy (reverse proxy)
+
+Ajouter dans `~/lake/infra/caddy/Caddyfile` :
+
+```caddyfile
+homarr.talloires.local, homarr.talloires.tailfd281f.ts.net {
+    import authelia
+    reverse_proxy homarr:7575
+    import internal_tls
+}
+```
+
+Recharger Caddy :
+
+```bash
+docker exec caddy caddy reload --config /etc/caddy/Caddyfile
+```
+
+## Configuration
+
+### Services à ajouter
+
+| Service | URL interne | Icône |
+|---------|-------------|-------|
+| Jellyfin | `http://jellyfin:8096` | jellyfin |
+| Radarr | `http://gluetun:7878` | radarr |
+| Sonarr | `http://gluetun:8989` | sonarr |
+| Prowlarr | `http://gluetun:9696` | prowlarr |
+| Transmission | `http://gluetun:9091` | transmission |
+| Home Assistant | `http://homeassistant:8123` | home-assistant |
+| Gitea | `http://gitea:3000` | gitea |
+| Grafana | `http://grafana:3000` | grafana |
+| Portainer | `http://portainer:9000` | portainer |
+
+### Intégrations *arr
+
+Homarr peut afficher des widgets avec stats en temps réel :
+
+1. **Ajouter un service** → Radarr
+2. **Integration** → Activer
+3. **API Key** : `b87fbcc6737e4d6a8c3c64f91bb81cef`
+4. Les widgets afficheront : films en queue, espace disque, activité
+
+### Widgets disponibles
+
+| Widget | Fonction |
+|--------|----------|
+| **Calendar** | Prochaines sorties (Sonarr/Radarr) |
+| **Download Queue** | Torrents actifs |
+| **System Health** | CPU, RAM, disque |
+| **Docker** | Status containers |
+| **Weather** | Météo locale |
+| **Bookmarks** | Liens rapides |
+
+## Structure des données
+
+```
+~/lake/tools/homarr/
+├── docker-compose.yml
+├── configs/           # Configuration dashboard
+│   └── default.json
+├── icons/             # Icônes custom
+└── data/              # Données persistantes
+```
+
+## Accès
+
+| Réseau | URL |
+|--------|-----|
+| LAN | [homarr.talloires.local](https://homarr.talloires.local) |
+| Tailscale | [homarr.talloires.tailfd281f.ts.net](https://homarr.talloires.tailfd281f.ts.net) |
+
+## Alternatives
+
+| Dashboard | Avantages | Inconvénients |
+|-----------|-----------|---------------|
+| **Homarr** | Intégrations *arr, moderne | Ressources |
+| **Homepage** | Léger, YAML config | Moins de widgets |
+| **Heimdall** | Simple | Pas d'intégrations |
+| **Organizr** | Tabs, auth intégrée | Complexe |
+
+## Dépannage
+
+### Docker socket permission
+
+```bash
+# Si erreur de permission
+sudo chmod 666 /var/run/docker.sock
+```
+
+### Icônes manquantes
+
+Télécharger depuis [Dashboard Icons](https://github.com/walkxcode/dashboard-icons) :
+
+```bash
+cd ~/lake/tools/homarr/icons
+wget https://raw.githubusercontent.com/walkxcode/dashboard-icons/main/png/radarr.png
+```