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

This commit is contained in:
Lionel
2026-01-13 16:00:01 +01:00
parent 008421a344
commit ee538cbc50
3 changed files with 284 additions and 0 deletions

137
docs/services/helmarr.md Normal file
View File

@@ -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/<votre_token>
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.

145
docs/services/homarr.md Normal file
View File

@@ -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
```