03_Homarr

homarr2026

A modern and easy to use dashboard. 30+ integrations. 10K+ icons built in. Authentication out of the box. No YAML, drag and drop configuration.

Ports

Volumes

Integration Claude Code — MCP

Outils disponibles

• get_all_boards
• get_board_items
• get_home_board
• get_integrations
• trpc_call

Ce que nous pouvons faire ensemble

• Lire la configuration du tableau de bord principal
• Lister les services et widgets configurés
• Consulter les intégrations actives (Jellyfin, Sonarr, etc.)
• Appeler des procédures tRPC personnalisées

Mise a jour disponible (verifie le 2026-07-19)

Attention : migration majeure, pas un simple bump

Le projet a ete entierement reecrit en version 1.0 et le depot a change de proprietaire : ghcr.io/ajnart/homarr -> ghcr.io/homarr-labs/homarr. Le stack VPS (homarr2026) utilise deja l'image homarr-labs avec le tag latest et un volume /appdata, donc une partie de la migration structurelle semble deja faite -- a verifier avant de bumper vers un tag fige.

Principaux breaking changes (0.x -> 1.0)

• Variables d'env renommees : DATABASE_URL -> DB_URL (conditionnelle), DOCKER_HOST -> DOCKER_HOSTNAMES + DOCKER_PORTS, AUTH_PROVIDER -> AUTH_PROVIDERS
• Nouvelle variable requise : SECRET_ENCRYPTION_KEY
• Variables supprimees : DISABLE_ANALYTICS, AUTH_OIDC_TIMEOUT, AUTH_LDAP_ADMIN_GROUP, AUTH_LDAP_OWNER_GROUP, AUTH_OIDC_ADMIN_GROUP, AUTH_OIDC_OWNER_GROUP (gestion des groupes/permissions passee dans l'UI)
• /data restructure et deplace vers /appdata (non retrocompatible)
• /app/data/configs (JSON) et /app/public/icons abandonnes -- gestion des icones et des configs via l'UI
• Support ARM v7 supprime
• Tous les widgets reecrits ; systeme d'integrations passe en asynchrone (fetch en arriere-plan + WebSockets/bus de messages)
• Test de connexion desormais obligatoire avant d'activer une integration

Nouveautes notables depuis la 1.0 (jusqu'a 1.71.0)

• v1.65.0 -- support MCP (integration IA), nouvelles integrations Beszel, Technitium DNS, Uptime Kuma, Audiobookshelf, Paperless-ngx, Navidrome ; widgets personnalises ; sauvegarde/restauration SQLite avec apercu WASM ; cache Redis global
• v1.66.1 -- support des groupes locaux OIDC
• v1.68.0 -- ameliorations de l'interface Beszel (stats en direct)
• v1.69.0 -- menu contextuel (clic droit) sur les widgets avec actions auto-generees, evenements calendrier au survol avec epinglage au clic, stockage de secrets par widget
• v1.70.0 -- integrations Traefik (widget dedie), Bazarr, PatchMon, et monitoring systeme Synology ; widgets media manquants/en file d'attente pour Radarr et Sonarr
• v1.71.0 -- support direction de texte pour le widget notes, bouton de rafraichissement compact sur le widget Docker, tri ameliore des torrents qBittorrent

Etapes de migration recommandees

1. Sauvegarder /home/debian/docker/homarr2026/appdata avant toute action
2. Exporter la config du dashboard depuis l'UI (fonction export/backup SQLite)
3. Verifier les variables d'environnement du compose homarr2026 contre la liste des breaking changes ci-dessus (notamment SECRET_ENCRYPTION_KEY, DOCKER_HOSTNAMES/DOCKER_PORTS)
4. Redeployer le stack, puis retester chaque integration (Jellyfin, Sonarr, etc.) -- test de connexion obligatoire en 1.x
5. Reimporter la sauvegarde SQLite si necessaire

Sources : github.com/homarr-labs/homarr/releases, homarr.dev/blog - Homarr 1.0