202601docs/docs/services/homarr.md

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 — Open source, MIT License

Déploiement

Docker Compose

Créer ~/lake/tools/homarr/docker-compose.yml :

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

cd ~/lake/tools/homarr
docker compose up -d

Caddy (reverse proxy)

Ajouter dans ~/lake/infra/caddy/Caddyfile :

homarr.talloires.local, homarr.talloires.tailfd281f.ts.net {
    import authelia
    reverse_proxy homarr:7575
    import internal_tls
}

Recharger Caddy :

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
Tailscale	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

# Si erreur de permission
sudo chmod 666 /var/run/docker.sock

Icônes manquantes

Télécharger depuis Dashboard Icons :

cd ~/lake/tools/homarr/icons
wget https://raw.githubusercontent.com/walkxcode/dashboard-icons/main/png/radarr.png