Homepage auf Saplo installieren (Start-Dashboard)

Wer mehr als eine Anwendung auf Box betreibt, verliert früher oder später den Überblick, unter welcher Adresse n8n zu finden ist, wo das Uptime Kuma Panel ist und wo Grafana für den Kunden steht. Die Lösung ist eine Startseite mit einer Linkliste, die du öffnest, anstatt einen Tab im Browser zu suchen. Homepage macht genau das als Open-Source-Dashboard, das du auf deiner eigenen Box ohne Datenbank und ohne monatliche Rechnung installierst. Im Folgenden erfährst du Schritt für Schritt, wie du Homepage auf Saplo installierst.

Warum Homepage statt Browser-Lesezeichen?

Browser-Lesezeichen funktionieren, solange die Anzahl der Anwendungen gering ist und du alle von einem Computer aus öffnest. Das Problem beginnt, wenn:

• die Zahl der Anwendungen wächst - eine Agentur mit mehreren Kunden und internen Tools (n8n, Monitoring, CMS-Panel) kommt schnell auf ein Dutzend Adressen, die man sich merken oder speichern muss.
• mehr als eine Person die Tools nutzt - Lesezeichen im privaten Browser helfen dem Team nicht. Jeder muss eine separate Adressliste erhalten, und bei einer Domänenänderung muss diese erneut verteilt werden.

Homepage löst dies als einzelner Docker-Container auf deiner Box: eine Seite mit Links, die du jedem im Team zur Verfügung stellst, ohne Begrenzung der Anzahl der Anwendungen und ohne zusätzliche Kosten, außer denen der Box selbst.

Anforderungen

Um Homepage auf Saplo zu hosten, benötigst du Folgendes:

• Eine Box mit laufendem Docker (die Engine startet ihn automatisch bei der Installation aus dem Katalog; Container-Nesting ist erforderlich, was Saplo standardmäßig bietet).
• Mindestens 512 MB freien RAM auf der Box und 2 GB Speicherplatz, d.h. der Box S Plan reicht aus.
• Eine Domain oder Subdomain *.saploapp.pl, die in jedem Plan enthalten ist, unter der das Dashboard zugänglich sein wird.
• Du benötigst KEINE separate Datenbank; Homepage speichert die gesamte Konfiguration in YAML-Dateien im Docker-Volume.

Schritt-für-Schritt-Installation

1. Gehe im Saplo-Panel zu App-Katalog und wähle Homepage (Kategorie "Business").
2. Wähle eine Box mit mindestens 512 MB freiem RAM, auf der das Dashboard installiert werden soll, sowie die Domain oder Subdomain, unter der es laufen wird.
3. Bestätige die Installation. Die Engine erstellt einen Container aus dem offiziellen Image ghcr.io/gethomepage/homepage, stellt ihn ausschließlich auf dem Loopback der Box bereit und verbindet ihn mit Nginx, der ihn unter der angegebenen Domain mit kostenlosem SSL bereitstellt. Nach außen ist nur Port 443 freigegeben, nicht der rohe Port 3000 des Containers.
4. Nach docker compose up prüft die Engine zusätzlich, ob das Dashboard tatsächlich unter dem Endpunkt /api/healthcheck auf HTTP antwortet, denn der Status "Container läuft" bedeutet nicht, dass der Prozess im Inneren nicht kurz darauf in einer Neustartschleife gelandet ist.
5. Nach Abschluss der Installation ist das Homepage-Panel unter der angegebenen Domain verfügbar, gesichert mit einem bei der Installation automatisch generierten Passwort (gespeichert in der SETUP-Datei auf der Box).

Erste Konfiguration

Homepage hat keinen Einrichtungsassistenten oder Administrator-Konto, sondern eine integrierte Ein-Passwort-Autorisierung, die sofort bei der Installation aktiviert wird.

1. Gehe zur Domain-Adresse, zum Beispiel start.saploapp.pl, und melde dich mit dem Passwort aus der Datei HOMEPAGE-SETUP.txt auf der Box an.
2. Eigene Links zu Anwendungen trägst du manuell in der Datei services.yaml im Konfigurationsvolumen ein. Jeder Eintrag besteht aus Name, Adresse und einem optionalen Icon.
3. Wetter-Widgets, den Status von Docker-Containern oder Statistiken von anderen Tools konfigurierst du in widgets.yaml, und Lesezeichen für externe Seiten in bookmarks.yaml.
4. Das Aussehen und Layout des Dashboards (Farben, Spaltenanzahl, Hintergrund) stellst du in settings.yaml ein.
5. Die Integration mit dem Docker-Socket der Box ist bei Saplo bewusst deaktiviert, daher erkennt Homepage NICHT automatisch andere Container. Jede Anwendung trägst du manuell ein. Diese Einschränkung gilt auch für jedes andere Setup auf einer Box, die mit anderen Kunden geteilt wird.

Homepage auf Saplo vs. Browser-Lesezeichen

Häufig gestellte Fragen

Benötigt Homepage eine separate Datenbank? Nein, die gesamte Konfiguration befindet sich in YAML-Dateien im Docker-Volume, die Saplo-Engine stellt dafür keinen zusätzlichen Datenbank-Container bereit.

Sieht Homepage automatisch andere Anwendungen auf der Box? Nein, die Integration mit dem Docker-Socket des Hosts ist aus Sicherheitsgründen für die Box, die mit anderen Kunden geteilt wird, bewusst deaktiviert. Links zu Anwendungen fügst du manuell in der Datei services.yaml hinzu.

Wie ändere ich das Dashboard-Passwort? Du bearbeitest die Variable HOMEPAGE_AUTH_PASSWORD in den Container-Optionen im Saplo-Panel und startest die Anwendung neu. Das Standardpasswort ist zufällig und in der Datei HOMEPAGE-SETUP.txt auf der Box gespeichert.

Muss man Docker selbst installieren, bevor man Homepage einrichtet? Nein, die Saplo-Engine installiert Docker CE automatisch bei der ersten Installation einer beliebigen Container-Anwendung auf der jeweiligen Box.

Wenn du mehrere Anwendungen auf deiner Box hast und einen zentralen Startpunkt für sie benötigst, anstatt nach den Tabs zu suchen, schreib uns, wir helfen dir gerne, die passende Box für dein Toolset auszuwählen.