diff --git a/docs/services/helmarr.md b/docs/services/helmarr.md new file mode 100644 index 0000000..9f949b3 --- /dev/null +++ b/docs/services/helmarr.md @@ -0,0 +1,137 @@ +# Helmarr (iOS) + +Application iOS native pour gérer les services Servarr depuis iPhone/iPad. + +## Présentation + +Helmarr est une app iOS/iPadOS/macOS pour contrôler Radarr, Sonarr, Prowlarr, Transmission et autres services *arr depuis mobile. Interface native, widgets Home Screen, notifications push. + +!!! info "App Store" + [Helmarr sur l'App Store](https://apps.apple.com/app/helmarr/id1638624921) — Gratuit + +## Services supportés + +| Service | Fonction | Supporté | +|---------|----------|----------| +| Sonarr | Séries TV | ✅ | +| Radarr | Films | ✅ | +| Lidarr | Musique | ✅ | +| Prowlarr | Indexeurs | ✅ | +| Transmission | Torrents | ✅ | +| Tautulli | Stats Plex | ✅ | +| Overseerr/Jellyseerr | Requêtes | ✅ | +| SABnzbd/NZBGet | Usenet | ✅ | + +## Configuration Talloires + +### URLs et API Keys + +| Service | URL Tailscale | API Key | +|---------|---------------|---------| +| **Radarr** | `https://radarr.talloires.tailfd281f.ts.net` | `b87fbcc6737e4d6a8c3c64f91bb81cef` | +| **Sonarr** | `https://sonarr.talloires.tailfd281f.ts.net` | `eb2cc87743de4ff18944d684f7e33da2` | +| **Prowlarr** | `https://prowlarr.talloires.tailfd281f.ts.net` | `813a9853a8bc468c8d6a4f013373cff7` | +| **Transmission** | `https://transmission.talloires.tailfd281f.ts.net` | *(auth basique)* | + +!!! warning "Sécurité" + Ces API keys donnent un accès complet aux services. Ne pas partager. + +### Étapes de configuration + +1. **Installer Helmarr** depuis l'App Store + +2. **Ajouter Radarr** : + - Tap `+` → `Radarr` + - **Host** : `radarr.talloires.tailfd281f.ts.net` + - **Port** : `443` + - **API Key** : `b87fbcc6737e4d6a8c3c64f91bb81cef` + - **SSL** : ✅ Activé + - **Validate Certificate** : ✅ (certificat Tailscale valide) + +3. **Ajouter Sonarr** : + - Tap `+` → `Sonarr` + - **Host** : `sonarr.talloires.tailfd281f.ts.net` + - **Port** : `443` + - **API Key** : `eb2cc87743de4ff18944d684f7e33da2` + - **SSL** : ✅ Activé + +4. **Ajouter Prowlarr** : + - Tap `+` → `Prowlarr` + - **Host** : `prowlarr.talloires.tailfd281f.ts.net` + - **Port** : `443` + - **API Key** : `813a9853a8bc468c8d6a4f013373cff7` + - **SSL** : ✅ Activé + +5. **Ajouter Transmission** : + - Tap `+` → `Transmission` + - **Host** : `transmission.talloires.tailfd281f.ts.net` + - **Port** : `443` + - **SSL** : ✅ Activé + +### Multi-réseau (LAN + Tailscale) + +Helmarr supporte plusieurs hôtes avec basculement automatique : + +| Réseau | URL | Quand | +|--------|-----|-------| +| **Tailscale** | `*.talloires.tailfd281f.ts.net` | Partout (recommandé) | +| **LAN** | `*.talloires.local` | À la maison uniquement | + +!!! tip "Configuration recommandée" + Utiliser uniquement les URLs Tailscale — fonctionne partout tant que Tailscale est connecté sur l'iPhone. + +## Fonctionnalités + +### Widgets Home Screen + +- **Calendrier** : Prochaines sorties séries/films +- **Téléchargements** : Queue active +- **Statistiques** : Taille bibliothèque + +### Notifications Push + +Configurer dans chaque *arr app → Settings → Connect → Webhook : + +``` +URL: https://helmarr.app/webhook/ +Events: On Download, On Upgrade +``` + +### Recherche interactive + +- Parcourir IMDb Most Popular +- Rechercher et ajouter directement +- Interactive search pour choisir la release + +## Authentification + +!!! success "Pas d'Authelia requis" + Les endpoints `/api/*` sont configurés sans Authelia dans Caddy. + Helmarr accède directement aux APIs avec la clé API. + +## Alternatives + +| App | Prix | Avantages | +|-----|------|-----------| +| **Helmarr** | Gratuit | Interface unifiée, widgets | +| **Ruddarr** | Gratuit (premium $6/an) | Plus joli, open source | +| **LunaSea** | Gratuit, open source | Plus d'apps supportées | + +## Dépannage + +### "Unable to connect" + +1. Vérifier que Tailscale est connecté sur l'iPhone +2. Tester l'URL dans Safari : `https://radarr.talloires.tailfd281f.ts.net/api/v3/system/status?apikey=...` +3. Vérifier que le service tourne : `docker ps | grep radarr` + +### Certificat invalide + +Les certificats Tailscale sont valides. Si erreur : + +- Désactiver temporairement "Validate Certificate" +- Vérifier que l'heure iPhone est correcte + +### Lenteur + +Les services tournent derrière gluetun (VPN). Latence normale ~100-200ms. diff --git a/docs/services/homarr.md b/docs/services/homarr.md new file mode 100644 index 0000000..bf7bfa7 --- /dev/null +++ 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 +``` diff --git a/mkdocs.yml b/mkdocs.yml index eaa7f71..e772bf9 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -27,6 +27,8 @@ nav: - Overview: services/overview.md - Transmission: services/transmission.md - Servarr: services/servarr.md + - Helmarr: services/helmarr.md + - Homarr: services/homarr.md - Changelog: - 2026-01-12: changelog/2026-01-12.md - 2026-01-03: changelog/2026-01-03.md