Comment installer Homepage sur Saplo (tableau de bord de démarrage)

Si tu installes plus d'une application sur une Box, tôt ou tard tu perdras le fil : quelle adresse mène à n8n, où se trouve le panneau Uptime Kuma, et où est le Grafana de ton client ? La solution est une page de démarrage unique avec une liste de liens que tu ouvres au lieu de chercher un onglet dans ton navigateur. Homepage fait exactement cela, en tant que tableau de bord open source que tu installes sur ta propre Box, sans base de données et sans facture mensuelle. Voici comment installer Homepage sur Saplo, étape par étape.

Pourquoi Homepage plutôt que les favoris du navigateur

Les favoris de votre navigateur fonctionnent tant que le nombre d'applications est faible et que vous les ouvrez tous depuis un seul ordinateur. Le problème commence quand :

• le nombre d'applications augmente - une agence avec plusieurs clients et plusieurs outils internes (n8n, monitoring, panneau CMS) atteint rapidement une douzaine d'adresses à mémoriser ou à enregistrer.
• plusieurs personnes utilisent les outils - les favoris dans un navigateur privé n'aideront pas l'équipe, chacun doit recevoir la liste des adresses séparément, et si le domaine change, elle doit être renvoyée à nouveau.

Homepage résout ce problème en tant que conteneur Docker unique sur votre Box : une seule page avec des liens que vous donnez à tous les membres de l'équipe, sans limite sur le nombre d'applications et sans aucun coût, à l'exception du coût de la Box elle-même.

Exigences

Pour installer Homepage sur Saplo, tu as besoin :

• D'une Box avec Docker activé (le moteur l'active automatiquement lors de l'installation depuis le catalogue, le nesting dans le conteneur est requis, ce que Saplo propose par défaut),
• D'un minimum de 512 Mo de RAM libre sur la Box et de 2 Go d'espace disque, ce qui signifie que le plan Box S à 27 € par an est suffisant,
• D'un domaine ou d'un sous-domaine *.saploapp.pl inclus avec chaque plan, sur lequel le tableau de bord sera hébergé,
• Tu N'as PAS besoin d'une base de données séparée, Homepage stocke toute sa configuration dans des fichiers YAML dans le volume Docker.

Installation étape par étape

1. Dans ton panneau Saplo, va dans le Catalogue d'applications et sélectionne Homepage (catégorie "Business").
2. Indique la Box avec un minimum de 512 Mo de RAM libre sur laquelle le tableau de bord doit être installé, ainsi que le domaine ou le sous-domaine sous lequel il fonctionnera.
3. Confirme l'installation. Le moteur installe un conteneur à partir de l'image officielle ghcr.io/gethomepage/homepage, l'expose uniquement sur la boucle locale de la Box et le connecte à Nginx, qui le sert sous le domaine spécifié avec un SSL gratuit. Seul le port 443 est exposé à l'extérieur, pas le port brut 3000 du conteneur.
4. Après docker compose up, le moteur vérifie également si le tableau de bord répond réellement en HTTP sur le point d'accès /api/healthcheck, car le simple statut "conteneur en cours d'exécution" ne signifie pas que le processus interne n'est pas tombé dans une boucle de redémarrages peu de temps après.
5. Une fois l'installation terminée, le panneau Homepage est disponible sous le domaine spécifié, sécurisé par un mot de passe généré automatiquement lors de l'installation (enregistré dans le fichier SETUP sur la Box).

Première configuration

Homepage n'a pas d'assistant ni de compte administrateur, juste une autorisation intégrée à mot de passe unique, activée dès l'installation.

1. Accède à l'adresse de domaine, par exemple start.saploapp.pl, et connecte-toi avec le mot de passe du fichier HOMEPAGE-SETUP.txt sur la Box.
2. Tu ajoutes manuellement tes propres liens vers les applications dans le fichier services.yaml dans le volume de configuration. Chaque entrée est un nom, une adresse et une icône optionnelle.
3. Tu configures les widgets météo, le statut des conteneurs Docker ou les statistiques d'autres outils dans widgets.yaml, et les favoris pour les sites externes dans bookmarks.yaml.
4. Tu définis l'apparence et la disposition du tableau de bord (couleurs, nombre de colonnes, arrière-plan) dans settings.yaml.
5. L'intégration avec le socket Docker de la Box est désactivée intentionnellement chez Saplo, donc Homepage NE détecte PAS automatiquement les autres conteneurs. Tu dois ajouter chaque application manuellement, c'est la même restriction que pour toute autre recette sur une Box partagée avec d'autres clients.

Homepage sur Saplo vs. les favoris du navigateur

Questions fréquentes

Est-ce que Homepage a besoin d'une base de données séparée ? Non, toute la configuration se trouve dans les fichiers YAML du volume Docker. Le moteur Saplo n'y ajoute aucun conteneur de base de données supplémentaire.

Est-ce que Homepage détecte automatiquement les autres applications sur la Box ? Non, l'intégration avec le socket Docker de l'hôte est volontairement désactivée pour des raisons de sécurité de la Box partagée avec d'autres clients. Tu ajoutes manuellement les liens vers les applications dans le fichier services.yaml.

Comment changer le mot de passe du tableau de bord ? Tu modifies la variable HOMEPAGE_AUTH_PASSWORD dans les options du conteneur dans le panneau Saplo et tu redémarres l'application. Le mot de passe par défaut est aléatoire et enregistré dans le fichier HOMEPAGE-SETUP.txt sur la Box.

Faut-il installer Docker soi-même avant de configurer Homepage ? Non, le moteur Saplo installe Docker CE automatiquement lors de la première installation de toute application conteneurisée sur une Box donnée.

Si tu as plusieurs applications sur ta Box et que tu souhaites avoir un seul point de départ pour toutes au lieu de chercher des onglets, écris-nous, nous t'aiderons à choisir la Box adaptée à ton ensemble d'outils.