Files
2026-06-09 18:40:21 +02:00

4.2 KiB


title: Homepage created: 2026-06-07 updated: 2026-06-07 type: app tags: [catalogue, dashboard, moderne, api, integrations] confidence: high contested: false sources: [https://selfh.st/apps/?tag=Dashboard, https://github.com/gethomepage/homepage]

📊 Homepage

Le dashboard self-hosted le plus moderne du moment, pensé dès l'origine pour s'intégrer nativement avec des dizaines de services via leurs API.

📋 Informations Générales

Champ Valeur
Nom Homepage
Site web https://gethomepage.dev
GitHub https://github.com/gethomepage/homepage
License GPL-3.0
Langage Node.js / React
Étoiles GitHub 30 536
Dernière MAJ 2026 (très active)
Catégorie cat-dashboard
Image Docker ghcr.io/gethomepage/homepage
Stack Next.js + containers
Origine Communauté open source
Multi-utilisateur Limité (mono-instance)

📝 Description

Homepage se positionne comme le successeur moderne des dashboards classiques. Sa philosophie : au lieu d'afficher des iframes passives, il interroge directement les API des services que vous utilisez (Sonarr, Radarr, Plex, qBittorrent, Pi-hole, AdGuard Home, Proxmox, Docker, Unifi, etc.) pour afficher des métriques temps réel : statut, téléchargements actifs, espaces disque, températures CPU, sessions VPN, etc.

L'interface est entièrement configurable en YAML (services.yaml + widgets.yaml + settings.yaml) avec une grande flexibilité : layouts en colonnes, groupes, bookmarks, recherche rapide, fond d'écran dynamique, et plus de 100 intégrations natives documentées.

⚠️ Note importante : Homepage évolue très vite. Les breaking changes sont fréquents entre versions majeures (migration de la v0.x vers v1.x, changements de schéma YAML). Il faut lire attentivement les release notes avant chaque upgrade et garder des sauvegardes de la configuration. La dépendance aux API des services implique également qu'un service modifié/cassé peut faire échouer l'affichage de son widget.

🚀 Installation

Via Docker (recommandé)

# docker-compose.yml
services:
  homepage:
    image: ghcr.io/gethomepage/homepage:latest
    container_name: homepage
    restart: unless-stopped
    environment:
      HOMEPAGE_ALLOWED_HOSTS: gethomepage.local:8080
    ports:
      - 8080:3000
    volumes:
      - ./config:/app/config
      - /var/run/docker.sock:/var/run/docker.sock:ro  # pour le widget Docker

Installation manuelle

Prérequis : Node.js 20+. Cloner le repo, pnpm install, pnpm build, pnpm start. Peu courant en production, Docker est la voie standard.

⚙️ Configuration

  • Trois fichiers YAML : settings.yaml (global), services.yaml (intégrations), widgets.yaml (bookmarks/groupes)
  • Widgets info : affichent statut détaillé avec API key + URL
  • Widgets bookmarks : liens simples avec icônes
  • Groupes imbriqués : pour organiser par catégorie
  • Recherche rapide : intégrée (DuckDuckGo, Google, ou custom)
  • Authentification : basique (utilisateur/mot de passe) ou via reverse proxy

🔗 Alternatives

  • Glance — Plus léger, sans dépendance API
  • Dashy — Riche, support multi-utilisateur
  • Homer — Statique pur, idéal pour usage familial

🔒 Sécurité

  • Supporte l'authentification HTTP basic (faible) ou OIDC via reverse proxy
  • Le socket Docker en read-only reste sensible : ne l'exposer que si le widget Docker est utilisé
  • Variables d'environnement pour les clés API : ne jamais les mettre en clair dans le YAML versionné
  • Mettre à jour régulièrement (dépendances Node.js)
  • Isoler derrière un VPN WireGuard ou Authelia pour l'accès distant

📚 Ressources

🔗 Pages Liées