Trace install tas - Homepage

Trace install tas - Homepage

Rôle

Tableau de bord des services.

Accès

• Local : http://10.8.0.1:8097
• Public : https://lololand.hopto.org:25697

Ports

8097 local, 25697 public via Caddy

Exécution / runtime

Quadlet systemd user : /home/loic/.config/containers/systemd/homepage.container ; conteneur systemd-homepage.

Paramètres importants à expliquer :

• `Image=ghcr.io/gethomepage/homepage:latest` : image du dashboard
• `AutoUpdate=registry` : activation des mises à jour automatiques via podman auto-update
• montage de `/home/loic/homepage-config` vers `/app/config` : la configuration affichée par Homepage vient de ce dossier hôte
• port local 8097 : point d'écoute local du service derrière Caddy

Chemins de configuration

• /home/loic/.config/containers/systemd/homepage.container
• /home/loic/homepage-config/services.yaml
• /home/loic/homepage-config/settings.yaml
• /home/loic/homepage-config/custom.js
• /home/loic/homepage-config/custom.css

Rôle des fichiers :

• `services.yaml` : cartes, liens, groupes et cibles de supervision / navigation
• `settings.yaml` : options globales de Homepage
• `custom.js` : comportements ou intégrations frontend spécifiques
• `custom.css` : surcharge visuelle locale

Volumes / persistance

• /home/loic/homepage-config -> /app/config

 * ce bind mount est la source de vérité de la configuration affichée

• pas de base de données dédiée documentée

Dépendances

• Caddy pour l'exposition publique
• liste des services documentée dans services.yaml

Procédure de relance / diagnostic

Relance standard :

• `systemctl --user restart homepage.service`

Vérifications utiles :

• `systemctl --user status homepage.service --no-pager -l`
• `systemctl --user cat homepage.service`
• `curl -I http://127.0.0.1:8097/`
• vérifier le rendu des cartes après modification de services.yaml

Explication des commandes :

• `systemctl --user cat` : montre l'unité réellement générée par Quadlet.
• `curl -I` : vérifie rapidement la disponibilité HTTP.
• `status --no-pager -l` : utile pour repérer un souci d'image, de bind mount ou de port.

Remarques

Image ghcr.io/gethomepage/homepage:latest avec AutoUpdate=registry. HOMEPAGE_ALLOWED_HOSTS configuré. Le dashboard porte les liens publics et internes des services.

Données / emplacements à sauvegarder

• Configuration dans /home/loic/homepage-config
• quadlet /home/loic/.config/containers/systemd/homepage.container
• pas de base de données applicative dédiée documentée

Sauvegarde

• Sauvegarder /home/loic/homepage-config (services.yaml, settings.yaml, custom.js, custom.css).
• Exporter aussi le quadlet /home/loic/.config/containers/systemd/homepage.container.

Restauration

• Restaurer /home/loic/homepage-config et le quadlet homepage.container.
• Recharger systemd user si nécessaire puis relancer le service.
• Vérifier ensuite l'accès local/public et la cohérence des liens vers les autres services.

Maintenance documentaire

Lors d'un changement de carte, port, image, lien public/interne, HOMEPAGE_ALLOWED_HOSTS ou custom.js/custom.css, mettre à jour cette page et la page centrale trace install tas.

Trace documentaire

Cette page fait partie de Trace install tas.