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

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

Volumes / persistance

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

Dépendances

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

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
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.
Relancer le service utilisateur associé à homepage si nécessaire.

Maintenance documentaire

Lors d'un changement de carte, port, lien public/interne 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.

Procédure d'ajout d'une carte (avec double lien HTTPS / Interne)

Pour ajouter un nouveau service au tableau de bord avec les boutons de liens distincts (externe et interne), il faut modifier deux fichiers :

1. Déclarer le service dans /home/loic/homepage-config/services.yaml : Ajouter la carte sous le groupe désiré (ex: Infrastructure). Il est indispensable de définir l'attribut id, car c'est lui qui sert de repère au script d'injection.

    - Mon Service:
        id: mon-service
        icon: icone.png
        href: https://lololand.hopto.org:PORT_EXT
        description: Description (Port interne PORT_INT)
        siteMonitor: http://10.8.0.1:PORT_INT

2. Configurer les liens doubles dans /home/loic/homepage-config/custom.js : Éditer le dictionnaire links au début du fichier en y ajoutant la correspondance entre l'id de la carte et ses deux URLs :

    'mon-service': { external: 'https://lololand.hopto.org:PORT_EXT', internal: 'http://10.8.0.1:PORT_INT' },

3. Appliquer les modifications : Redémarrer le conteneur pour que la configuration YAML soit rechargée (le JS et le CSS sont rechargés automatiquement au rafraîchissement de la page par le navigateur) :

systemctl --user restart homepage

Note : L'apparence des boutons est gérée globalement par les classes CSS personnalisées (.oc-dual-link, .oc-external, .oc-internal) définies dans /home/loic/homepage-config/custom.css.