Aller au contenu

Homer — Portail des services

Homer est le dashboard qui référence tous les sites et services exposés du VPS srv759970. Il remplace Dashy (décommissionné le 2026-06-11) : choisi pour être simple et léger (nginx statique, ~1-8 MB RAM, 0 CPU au repos) — adapté à un VPS sans swap.

Accès

Propriété Valeur
URL https://services.srv759970.hstgr.cloud
Auth auth_basic — /etc/nginx/.htpasswd (comptes famille)
Conteneur homer (image b4bz/homer:latest)
Bind 127.0.0.1:4000 → 8080 interne
Reverse proxy nginx services → SSL Let's Encrypt (expire 2026-09-09)
Empreinte mem_limit: 64m, cpus: 0.25 (constaté : ~1 MB RAM, 0 % CPU)

Fichiers

Emplacement Rôle
/opt/homer/config.yml (VPS) Config servie — source live
/opt/homer/docker-compose.yml (VPS) Définition conteneur
apps/14-server-configs/homer/ (repo) Source de vérité versionnée

⚠️ Garder le repo et le VPS synchronisés. Ne jamais laisser diverger (c'est ce qui avait rendu l'ancien Dashy obsolète).

Structure de la config

config.yml (YAML, rechargé au démarrage du conteneur) organise les services en sections thématiques :

  • 🌐 Sites & Applications — sites publics et apps métier
  • 🤖 IA & LLM — Open WebUI, LobeHub, Domo, Paperclip, Reading Coach…
  • 🎙️ Médias & Outils — audioguides, cooking, slides, STT/TTS…
  • ✉️ Mail — Webmail (Roundcube), Stalwart Admin
  • 🛠️ Infra & Admin — Family Dashboard, Docs, monitoring, Pi-Daemon
  • 🔌 MCP Servers — endpoints /mcp des serveurs MCP du VPS

Ajouter un nouveau service

C'est l'étape finale obligatoire de tout déploiement d'un service exposé (voir skill julien-infra-hostinger-web).

# 1. Éditer la config
ssh srv759970 'nano /opt/homer/config.yml'

Ajouter l'item dans la bonne section :

      - name: "Mon Service"
        subtitle: "Description courte"
        url: "https://mysite.srv759970.hstgr.cloud"

# 2. Recharger (instantané, pas de rebuild)
ssh srv759970 'docker restart homer'

# 3. Répercuter dans le repo (source de vérité)
scp srv759970:/opt/homer/config.yml \
  "apps/14-server-configs/homer/config.yml"

Règles :

  • Ne référencer que des services vivants (ss -tlnp | grep :PORT avant d'ajouter).
  • Retirer de config.yml tout service supprimé du VPS.
  • Respecter le rangement par section thématique.

Maintenance

# État du conteneur
ssh srv759970 'docker ps --filter name=homer'

# Logs (vérifier parsing YAML)
ssh srv759970 'docker logs homer --tail 20'

# Empreinte ressources
ssh srv759970 'docker stats homer --no-stream'

# Redémarrage / mise à jour image
ssh srv759970 'cd /opt/homer && docker compose pull && docker compose up -d'

Historique

  • 2026-06-11 : déploiement Homer en remplacement de Dashy (supprimé : conteneur, image, /opt/dashy, vhost nginx). Inventaire reconstruit depuis nginx sites-enabled réel.