146 lines
3.5 KiB
Markdown
146 lines
3.5 KiB
Markdown
# 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
|
|
```
|