🔄 Mise à jour — juin 2026. Homepage a été décommissionné le 2026-06-28 et remplacé par un hub statique fait main. Cet article décrit l’architecture telle qu’elle existait avant ce changement — conservé pour référence historique.
Un point d’entrée unique
Avec 15+ services exposés, naviguer dans le homelab sans dashboard centralisé devient fastidieux. Homepage résout ce problème avec une interface web clean, configurable en YAML, qui regroupe tous les services avec leurs statuts en temps réel.
Glances complète Homepage en exposant des métriques système détaillées (CPU, RAM, réseau, disque) via une API REST que Homepage consomme.
Homepage
Homepage est configuré entièrement via ConfigMaps. La configuration principale définit les services regroupés par catégorie :
# ConfigMap homepage-services
services.yaml: |
- Infrastructure:
- ArgoCD:
href: https://argocd.olig-homelab-2025.win
icon: argocd.png
description: GitOps controller
- Longhorn:
href: http://10.0.0.11:30080
icon: longhorn.png
description: Distributed storage (NodePort)
- Development:
- Gitea:
href: https://gitea.olig-homelab-2025.win
icon: gitea.png
description: Self-hosted Git
- code-server:
href: https://code.olig-homelab-2025.win
icon: vscode.png
description: VS Code in browser
- Claude WebUI:
href: https://claude.olig-homelab-2025.win
icon: anthropic.png
description: Claude Code via web UI
Homepage supporte des widgets pour afficher des métriques en direct depuis les services (statut ArgoCD, volumes Longhorn, uptime…) via leurs APIs.
Glances
Glances expose des métriques système via une API REST sur le port 61208. Homepage peut consommer cette API pour afficher CPU/RAM/réseau directement dans le dashboard.
Glances est déployé en mode serveur :
containers:
- name: glances
image: nicolargo/glances:latest
args: ["-w", "--disable-plugin", "docker"]
ports:
- containerPort: 61208
Leçons apprises
RBAC pour la découverte automatique : Homepage peut découvrir automatiquement les services Kubernetes en lisant les annotations sur les Ingress. Cela nécessite un ServiceAccount avec les permissions appropriées sur les ressources services, endpoints, et ingresses.
Icônes : Homepage dispose d’une bibliothèque d’icônes intégrée pour les services populaires. Pour les services custom, héberger les icônes dans le ConfigMap homepage-icons ou référencer une URL externe.
Rétrospective : ce dashboard a rempli son rôle jusqu’à son remplacement en juin 2026 (voir la mise à jour en tête d’article). L’essentiel de la valeur qu’il apportait — un point d’entrée unique vers les services du homelab — a été repris par son successeur.