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.