Installer Homepage : la page d'accueil de toutes vos applications

Au bout de quelques applications, on oublie les adresses. Homepage les rassemble sur une seule page, avec leur icône, leur état et des widgets. Mettez-la en page d’accueil de votre navigateur.

Installer

Dans Mon serveur, ajoutez Homepage avec vos autres applications. Adresse proposée : accueil.mondomaine.fr.

Bonus de Mon serveur : à la première installation, la page est pré-remplie avec toutes les applications du panier, rangées par catégorie, avec leur icône et leur adresse. Il n’y a rien à faire pour commencer.

Les fichiers de configuration

Tout se règle dans des fichiers texte, dans /opt/stacks/homepage/config/ :

Fichier	Contenu
`services.yaml`	vos applications, par groupes
`settings.yaml`	titre, langue, thème, disposition
`widgets.yaml`	les widgets du haut de page (météo, recherche, ressources)
`bookmarks.yaml`	des liens simples (favoris)

Homepage relit les fichiers tout seul : enregistrez, rechargez la page, c’est appliqué.

Ajouter une application

sudo nano /opt/stacks/homepage/config/services.yaml

- Fichiers et photos:
    - Nextcloud:
        href: https://cloud.mondomaine.fr
        description: "Vos fichiers, agenda et contacts."
        icon: nextcloud.png
    - Ma nouvelle appli:
        href: https://appli.mondomaine.fr
        description: "Ce qu'elle fait."
        icon: mdi-application

Respectez l’indentation (des espaces, jamais de tabulation).
icon : le nom d’une application connue (jellyfin.png, vaultwarden.png…) ou une icône mdi-… (Material Design Icons).

Quand vous ajoutez une application avec Mon serveur, ce fichier n’est pas réécrit, pour garder vos personnalisations : ajoutez-la ici à la main.

Des widgets utiles

Dans widgets.yaml :

- resources:
    cpu: true
    memory: true
    disk: /
- search:
    provider: duckduckgo
    target: _blank
- datetime:
    locale: fr
    format:
      dateStyle: long

Le widget resources affiche le processeur, la mémoire et le disque du conteneur, qui reflètent ceux du serveur.

L’erreur « Host validation failed »

Homepage n’accepte que l’adresse déclarée à l’installation (variable HOMEPAGE_ALLOWED_HOSTS du compose.yml). Si vous l’ouvrez par une autre adresse, il refuse (détails dans le décodeur). Ajoutez l’adresse, séparée par une virgule, puis :

cd /opt/stacks/homepage && sudo docker compose up -d

Garder la page privée

Homepage n’a pas de mot de passe. Il n’affiche que des liens (les applications ont chacune leur connexion), mais il révèle la liste de vos services. Si ça vous gêne, protégez-le avec un mot de passe au niveau du reverse proxy (middleware basicAuth de Traefik), ou ne le rendez accessible que par Tailscale.

Une commande qui ne marche pas, une explication pas claire ? Signaler une erreur dans cette page.