Homepage-Dashboard per Docker einrichten¶

Veröffentlicht am 28. Juli 2026 · Geschätzte Lesezeit: 3 Minuten

Mit Homepage sammelst du Links zu Home Assistant, Router, NAS und selbst gehosteten Diensten auf einer übersichtlichen Startseite. Die Oberfläche liest eine einfache YAML-Datei und braucht für reine Verknüpfungen keinen Zugriff auf den Docker-Socket. Die Einrichtung dauert etwa 15 Minuten. Grundlage sind die offizielle Docker-Anleitung und die Dokumentation für Dienste (Stand: 28. Juli 2026).

Voraussetzungen

Ein Linux-Server mit Docker und Docker Compose
Ein Benutzerkonto mit Berechtigung für Docker
Port 3000 im Heimnetz frei
Die Adressen deiner wichtigsten Smart-Home- und Self-Hosting-Dienste

1. Arbeitsordner anlegen¶

Führe die folgenden Befehle auf deinem Docker-Server aus. Sie erstellen den Ordner für Compose-Datei und Homepage-Konfiguration:

mkdir -p ~/homepage/config

cd ~/homepage

2. Compose-Datei anlegen¶

Lege im Ordner ~/homepage eine Datei namens compose.yaml an. Ersetze <server-ip> vor dem Start durch die feste IP-Adresse deines Docker-Servers. Der erlaubte Host muss den Port enthalten, über den du Homepage im Browser öffnest:

services:
  homepage:
    image: ghcr.io/gethomepage/homepage:latest
    container_name: homepage
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      HOMEPAGE_ALLOWED_HOSTS: "<server-ip>:3000"
    volumes:
      - ./config:/app/config

Warum kein Docker-Socket?

Für ein Link-Dashboard ist /var/run/docker.sock nicht nötig. Ohne diese Einbindung erhält Homepage keine weitreichenden Informationen über deine Container. Docker-Statusanzeigen kannst du später gezielt und abgesichert ergänzen.

3. Dienste eintragen¶

Lege im Ordner ~/homepage/config die Datei services.yaml mit folgendem Beispiel an. Ersetze alle Platzhalter durch deine eigenen internen Adressen. Wenn du einen Dienst nicht verwendest, entfernst du seinen gesamten Block:

- Smart Home:
    - Home Assistant:
        icon: home-assistant
        href: "http://<home-assistant-ip>:8123"
        description: Geräte und Automationen

- Netzwerk:
    - Router:
        icon: router
        href: "http://<router-ip>"
        description: Netzwerkverwaltung

- Server:
    - NAS:
        icon: mdi-nas
        href: "https://<nas-ip>:<nas-port>"
        description: Dateien und Backups

<home-assistant-ip>, <router-ip> und <nas-ip> stehen für die jeweiligen IP-Adressen im Heimnetz. <nas-port> ersetzt du durch den HTTPS-Port der NAS-Oberfläche.

Keine Zugangsdaten eintragen

services.yaml enthält nur Links. Schreibe dort keine Benutzernamen, Passwörter, Zugriffsschlüssel oder Sitzungscookies hinein. Homepage stellt selbst keine sichere Passwortablage bereit.

4. Oberfläche auf Deutsch einstellen¶

Lege zusätzlich die Datei ~/homepage/config/settings.yaml an. Sie setzt Titel, Sprache und Farbschema:

title: Mein Heimnetz
language: de
theme: dark
color: slate
target: _self

Mit target: _self öffnen sich Dienste im selben Browser-Tab. Wenn du lieber neue Tabs verwendest, ersetzt du den Wert durch _blank.

5. Konfiguration prüfen und starten¶

Prüfe im Ordner ~/homepage zunächst die Compose-Datei:

docker compose config

Der ausgegebene Wert bei HOMEPAGE_ALLOWED_HOSTS darf keine spitzen Klammern mehr enthalten. Starte danach den Container:

docker compose up -d

Kontrolliere seinen Status:

docker compose ps

6. Dashboard testen¶

Öffne http://<server-ip>:3000 und ersetze <server-ip> durch die Server-IP. Prüfe jede Kachel einzeln. Eine Kachel kann korrekt angezeigt werden, obwohl ihr Ziel falsch oder nicht erreichbar ist.

Falls Homepage nicht startet oder eine YAML-Datei ablehnt, zeigen die letzten Container-Meldungen die Ursache:

docker compose logs --tail=100 homepage

Typische Fehler

Die Meldung Host validation failed weist meist auf einen falschen Wert bei HOMEPAGE_ALLOWED_HOSTS hin. Bei einer leeren oder fehlerhaften Seite prüfst du Einrückung und Doppelpunkte in services.yaml. YAML verwendet Leerzeichen statt Tabulatoren.

7. Backup und Rückweg¶

Stoppe Homepage kurz:

docker compose down

Wechsle in deinen persönlichen Ordner:

cd ~

Sichere das gesamte Projekt mit allen YAML-Dateien:

tar -czf homepage-backup.tar.gz homepage

Starte Homepage anschließend wieder:

cd ~/homepage

docker compose up -d

Für den Rückweg stoppst du den Container mit docker compose down. Die Konfigurationsdateien bleiben erhalten und können vor einem neuen Start aus dem Archiv wiederhergestellt werden.

Nur im Heimnetz bereitstellen

Homepage besitzt in dieser Konfiguration keine eigene Anmeldung. Öffne Port 3000 niemals per Router-Portfreigabe zum Internet. Nutze für externen Zugriff ein VPN oder einen Reverse Proxy mit HTTPS und Anmeldung.

Fertig¶

Dein persönliches Dashboard ist nun unter http://<server-ip>:3000 erreichbar. Die Einrichtung funktioniert, wenn alle Gruppen sichtbar sind und jede Kachel den richtigen Dienst im Heimnetz öffnet.