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.