Homepage : éditer services.yaml

Le fichier services.yaml définit les groupes, liens et widgets affichés sur le tableau de bord Homepage.

Prérequis

• Homepage déployé, dossier de config monté sur /app/config.
• Accès en écriture à /app/config/services.yaml.

1. Définir les groupes et services

Éditer /app/config/services.yaml :

- Supervision:
    - Grafana:
        href: https://grafana.exemple.fr
        icon: grafana.png
        description: Tableaux de bord
    - Prometheus:
        href: http://192.0.2.20:9090
        icon: prometheus.png

- Infrastructure:
    - Proxmox:
        href: https://192.0.2.10:8006
        icon: proxmox.png
        widget:
          type: proxmox
          url: https://192.0.2.10:8006
          username: api@pam!homepage
          password: jeton-api

2. Appliquer la configuration

Homepage recharge automatiquement. Sinon, redémarrer le conteneur :

docker restart homepage

3. Stocker les secrets hors fichier

Référencer une variable d’environnement plutôt qu’un mot de passe en clair :

        password: "{{HOMEPAGE_VAR_PROXMOX_TOKEN}}"

Vérification

Recharger la page : les groupes apparaissent dans l’ordre du fichier, chaque service est cliquable, le widget Proxmox affiche l’état du cluster.

Dépannage

• Page blanche : erreur YAML ; vérifier l’indentation (deux espaces, jamais de tabulation).
• Icône manquante : utiliser un nom du dépôt dashboard-icons ou un chemin local sous /app/config/icons.
• Widget vide : contrôler les droits du jeton API et l’URL exacte du service.