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