Homepage: das Dashboard für alle deine selbstgehosteten Dienste

Je mehr Dienste du selbst hostest, desto mehr Lesezeichen und IP-Adressen musst du dir merken. Ein Dashboard löst das: eine einzige Startseite, die alle deine Dienste verlinkt, die Systemlast zeigt und dir sogar sagt, welche Container gerade laufen. Homepage ist dafür das schönste und schnellste Werkzeug.

Was bauen wir?

Ein zentrales Dashboard mit Homepage (v1.13.2) hinter Traefik, das du komplett über einfache YAML-Dateien konfigurierst. Am Ende hast du eine aufgeräumte Startseite mit Kacheln für alle Dienste, Widgets für CPU/RAM/Festplatte, ein Suchfeld – und die Killer-Funktion: Homepage liest den Docker-Socket und zeigt live an, ob ein Container läuft. Alles statisch generiert, ohne Datenbank, mit winzigem Ressourcenbedarf.

Voraussetzungen

• Ein Server mit laufendem Traefik und Docker Compose
• Eine Subdomain, die auf den Server zeigt – im Folgenden DEINE_DOMAIN (z. B. start.deinedomain.de)
• Ein paar bereits laufende Dienste, die du verlinken willst (macht mehr Spaß, ist aber nicht Pflicht)

Schritt für Schritt

Schritt 1: Projekt und Konfigurationsordner anlegen

Homepage wird ausschließlich über YAML-Dateien in einem config-Ordner gesteuert. Lege die Struktur an:

mkdir -p /opt/homepage/config /opt/homepage/icons && cd /opt/homepage

Schritt 2: Grundeinstellungen

Die config/settings.yaml bestimmt Aussehen und Layout. Wir definieren zwei Gruppen als Zeilen-Layout mit je drei Spalten:

title: Meine Serverküche
theme: dark
color: slate
headerStyle: boxed
layout:
  Infrastruktur:
    style: row
    columns: 3
  Medien:
    style: row
    columns: 3

Die Namen unter layout: (Infrastruktur, Medien) müssen später exakt mit den Gruppennamen in der Dienste-Datei übereinstimmen – nur dann greift das Layout.

Schritt 3: Dienste verlinken

Die config/services.yaml ist das Herzstück – deine Kacheln. Jeder Dienst bekommt einen Namen, eine URL, eine Beschreibung und ein Icon (Homepage lädt passende Icons automatisch aus einem großen Katalog, wenn du name.png angibst):

- Infrastruktur:
    - Nextcloud:
        href: https://cloud.DEINE_DOMAIN
        description: Eigene Cloud
        icon: nextcloud.png
    - Vaultwarden:
        href: https://vault.DEINE_DOMAIN
        description: Passwortmanager
        icon: vaultwarden.png
- Medien:
    - Immich:
        href: https://fotos.DEINE_DOMAIN
        description: Fotos
        icon: immich.png
    - Jellyfin:
        href: https://media.DEINE_DOMAIN
        description: Medienserver
        icon: jellyfin.png

So verlinkst du deine bereits installierten Dienste wie Nextcloud, Immich, Jellyfin oder Vaultwarden an einer zentralen Stelle.

Schritt 4: Widgets für Systemlast und Suche

Die config/widgets.yaml steuert die Info-Leiste oben. Ressourcen-Anzeige, ein Suchfeld und Datum/Uhrzeit:

- resources:
    cpu: true
    memory: true
    disk: /
- search:
    provider: duckduckgo
    target: _blank
- datetime:
    text_size: xl
    format:
      dateStyle: full
      timeStyle: short

Das resources-Widget zeigt die Auslastung des Hosts. CPU und RAM liest Homepage direkt aus dem Container heraus (kein Docker-Socket nötig); den Socket binden wir erst im nächsten Schritt für den Container-Status ein.

Schritt 5: Mit Traefik verbinden – und der entscheidende Host-Schutz

Jetzt die compose.yaml. Ersetze DEINE_DOMAIN durch deine echte Subdomain:

services:
  homepage:
    image: ghcr.io/gethomepage/homepage:v1.13.2
    restart: unless-stopped
    environment:
      HOMEPAGE_ALLOWED_HOSTS: DEINE_DOMAIN
    volumes:
      - ./config:/app/config
      - ./icons:/app/public/icons
    networks: [proxy]
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.homepage.rule=Host(`DEINE_DOMAIN`)"
      - "traefik.http.routers.homepage.entrypoints=websecure"
      - "traefik.http.routers.homepage.tls.certresolver=le"
      - "traefik.http.services.homepage.loadbalancer.server.port=3000"

networks:
  proxy:
    external: true

Starte das Dashboard:

docker compose up -d

Prüfe von außen, dass es mit gültigem HTTPS antwortet:

curl -sI https://DEINE_DOMAIN/ | head -1

HTTP/2 200

Im Browser siehst du jetzt dein Dashboard mit den Kacheln und der Info-Leiste:

Schritt 6: Live-Container-Status über den Docker-Socket

Die stärkste Funktion: Homepage kann direkt aus Docker lesen, ob ein Container läuft, und CPU/RAM je Container anzeigen. Dafür legst du config/docker.yaml an:

my-docker:
  socket: /var/run/docker.sock

Dann bindest du den Socket schreibgeschützt in den Container ein – ergänze in der compose.yaml unter volumes::

      - /var/run/docker.sock:/var/run/docker.sock:ro

Und verknüpfst eine Kachel mit ihrem Container (server verweist auf den Namen aus docker.yaml, container auf den echten Container-Namen):

- Infrastruktur:
    - Traefik:
        description: Reverse Proxy
        icon: traefik.png
        server: my-docker
        container: traefik-traefik-1

Nach docker compose up -d zeigt die Kachel ein grünes Status-Abzeichen, sobald der Container läuft:

Schritt 7: Lesezeichen ergänzen (optional)

Neben Diensten kann Homepage auch reine Lesezeichen anzeigen – über config/bookmarks.yaml:

- Entwicklung:
    - Serverküche:
        - abbr: SK
          href: https://serverkueche.de

Damit hast du Dienste, Systemlast, Suche und Lesezeichen an einem Ort. Änderungen an den YAML-Dateien übernimmt Homepage automatisch – ein Neuladen im Browser genügt meist, kein Neustart nötig.

Wenn es nicht funktioniert

Wartung & Backups

• Updates sind unkritisch. Homepage hat keinen persistenten Zustand außer deinen Config-Dateien. Bump den Image-Tag (ghcr.io/gethomepage/homepage:v1.13.2) gelegentlich auf die neue Version und docker compose up -d; das übernimmt sonst dein normaler Update-Prozess. Prüfe nach größeren Sprüngen die Release-Notes, da sich Config-Optionen ändern können.
• Das Backup ist winzig. Sichere nur den config-Ordner (und ggf. eigene icons) – das ist deine gesamte Konfiguration. Er gehört ins Restic-Backup; die Anwendung selbst wird jederzeit aus dem Image neu erzeugt.
• Sicherheit nicht vergessen. Ein Dashboard mit Docker-Einblick ist ein lohnendes Ziel. Betreibe es nur hinter HTTPS (erledigt Traefik) und schütze es zusätzlich mit einer Authentifizierung, bevor es öffentlich erreichbar ist.