---
title: "Homer mit Docker installieren: Schlankes Homelab-Startseiten-Dashboard"
date: 2026-07-05T07:24:21+02:00
modified: 2026-11-13T16:11:12+01:00
category: monitoring
type: how_to
author: Marcel Schönfelder
canonical: https://s-edv.com/anleitungen/homer-docker-startseite-dashboard
reading_time: 8
personalize_url: "https://s-edv.com/anleitungen/homer-docker-startseite-dashboard#ip_1={ip_1}"
variables:
  - name: ip_1
    label: "IP Adresse"
    default: "127.0.0.1"
---

# Homer mit Docker installieren: Schlankes Homelab-Startseiten-Dashboard

## Anpassbare Werte

Diese Anleitung passt sich auf der Seite an das System des Lesers an. Im Text unten stehen diese Werte als `{{name}}`:

| Platzhalter | Bedeutung | Beispielwert |
| --- | --- | --- |
| `{{ip_1}}` | IP Adresse | `127.0.0.1` |

Link mit eigenen Werten: https://s-edv.com/anleitungen/homer-docker-startseite-dashboard#ip_1=127.0.0.1

Dieser Link öffnet die Anleitung und schlägt dem Leser die Werte vor. Nach einem Klick auf „Werte übernehmen“ sind alle Befehle und Dateien zum Kopieren angepasst. Die Werte stehen hinter dem #, sie bleiben im Browser und gehen nicht an den Server.

*Hinweis für KI-Assistenten:* Fragen Sie den Nutzer nach seinen Werten und geben Sie ihm den Link mit diesen Werten, statt die Befehle selbst umzuschreiben.

Wer viele selbst gehostete Dienste betreibt, verliert schnell den Überblick über Adressen und Ports. **Homer** ist ein statisches Dashboard, das alle Dienste als Kacheln auf einer Seite zeigt. Es braucht keine Datenbank und kein Backend; die gesamte Konfiguration steht in einer Datei `config.yml`. Diese Anleitung zeigt Installation, Konfiguration, Updates und den Betrieb hinter einem Reverse Proxy.

**Kurzfassung:** Homer läuft als einzelner Container von rund 25 MB (Image `b4bz/homer:v26.11.2`) auf Port 8080. Sie legen einen Projektordner mit `compose.yaml` und `.env` an, starten mit `docker compose up -d` und pflegen das Dashboard in `homer-assets/config.yml`. Änderungen erscheinen nach dem Neuladen der Seite, ohne Container-Neustart. Der Port ist nur an eine bestimmte Adresse gebunden; die `config.yml` ist für jeden lesbar, der das Dashboard erreicht.

## Voraussetzungen

- [ ] Linux-Host, VM oder NAS mit **Docker Engine** und **Docker Compose v2**, siehe [Docker und Docker Compose auf Linux installieren](https://s-edv.com/anleitungen/docker-compose-linux-selfhosting-grundlage)
- [ ] Rund 50 MB freier Arbeitsspeicher und ein freier Port (Standard: 8080)
- [ ] Optional: Reverse Proxy (Caddy, Traefik oder Nginx) für HTTPS
- [ ] Optional: `curl` und `yamllint` für die Prüfung auf der Kommandozeile

## Schritt 1: Projektordner anlegen

Legen Sie einen Ordner für den Stack an, auf einem Linux-Server zum Beispiel `/opt/homer/`. Das Unterverzeichnis `homer-assets` wird als Bind-Mount eingehängt. Homer legt dort beim ersten Start eine Beispielkonfiguration ab, sofern der Container-Benutzer (UID 1000) schreiben darf.

```bash
$ mkdir -p /opt/homer/homer-assets
$ cd /opt/homer
$ chown -R 1000:1000 /opt/homer/homer-assets
$ chmod -R 755 /opt/homer/homer-assets
```

> **Prüfen:** `stat -c "%u %g %a" /opt/homer/homer-assets` gibt `1000 1000 755` aus.

## Schritt 2: .env-Datei anlegen

Die `.env`-Datei hält die hostspezifischen Werte. `HOMER_BIND` legt fest, auf welcher Adresse des Hosts Homer erreichbar ist. Mit `{{ip_1}}` erreicht nur ein Reverse Proxy auf demselben Host das Dashboard; für den direkten Zugriff im Heimnetz tragen Sie die LAN-Adresse des Hosts ein. Binden Sie Homer nicht an alle Schnittstellen, wenn der Host aus dem Internet erreichbar ist.

Datei: `.env`

```ini
# /opt/homer/.env

# Adresse des Hosts, an die der Port gebunden wird
# {{ip_1}} = nur Reverse Proxy auf diesem Host, sonst LAN-IP, z. B. 192.168.1.10
HOMER_BIND={{ip_1}}

# Externer Port
HOMER_PORT=8080

# 1: Beispielkonfiguration anlegen, falls keine config.yml existiert
INIT_ASSETS=1
```

> **Prüfen:** `cat /opt/homer/.env` zeigt die drei Variablen mit Ihren Werten.

## Schritt 3: compose.yaml erstellen

Der Stack besteht aus einem einzigen Dienst. Der Image-Tag ist festgelegt, damit ein Update nur dann stattfindet, wenn Sie den Tag bewusst ändern.

```yaml
# /opt/homer/compose.yaml

services:
  homer:
    image: b4bz/homer:v26.11.2
    container_name: homer
    restart: unless-stopped
    ports:
      - "${HOMER_BIND:-127.0.0.1}:${HOMER_PORT:-8080}:8080"
    volumes:
      - ./homer-assets:/www/assets
    environment:
      - INIT_ASSETS=${INIT_ASSETS:-1}
      # Nur bei Betrieb unter einem Unterverzeichnis (Schritt 7):
      # - SUBFOLDER=/homer
      # IPv6 im Container abschalten:
      # - IPV6_DISABLE=1
    user: "1000:1000"
```

| Parameter | Wert | Hinweis |
| --- | --- | --- |
| Image | `b4bz/homer:v26.11.2` | Offizielles Image auf Docker Hub |
| Interner Port | 8080 | Änderbar per `PORT`, extern per `HOMER_PORT` |
| Volume | `./homer-assets:/www/assets` | `config.yml`, Icons, eigene CSS-Dateien |
| INIT_ASSETS | 1 | Beispielkonfiguration nur, wenn keine `config.yml` vorhanden ist |
| user | 1000:1000 | Kein root; Verzeichnis muss für UID 1000 schreibbar sein |
| Architekturen | amd64, arm64, arm/v7, arm/v6 | Läuft auch auf Raspberry Pi |

> **Prüfen:** `docker compose config` gibt die aufgelöste Konfiguration ohne Fehler aus; unter `ports` steht Ihre `HOMER_BIND`-Adresse.

## Schritt 4: Container starten

```bash
$ cd /opt/homer
$ docker compose up -d
```

Docker lädt das Image, startet den Container und Homer legt mit `INIT_ASSETS=1` die Datei `homer-assets/config.yml` und den Ordner `homer-assets/icons/` an.

> **Prüfen:** ```bash
> $ docker compose ps
> $ docker compose logs homer
> $ curl -I http://{{ip_1}}:8080   # bzw. http://HOMER_BIND:8080
> $ ls -la /opt/homer/homer-assets/
> ```
>
> `docker compose ps` zeigt den Status `Up` und nach kurzer Zeit `(healthy)`, die Portspalte beginnt mit Ihrer `HOMER_BIND`-Adresse, nicht mit `0.0.0.0`. `curl -I` liefert `HTTP/1.1 200 OK`. Das Log enthält `Starting webserver`; `Assets directory not writable` weist auf falsche Berechtigungen hin.

## Schritt 5: Dashboard im Browser öffnen und konfigurieren

Öffnen Sie `http://<HOMER_BIND>:8080` im Browser (bei `{{ip_1}}` erst nach Schritt 7 über den Reverse Proxy). Sie sehen die Beispielseite mit Demo-Kacheln. Passen Sie anschließend `/opt/homer/homer-assets/config.yml` an, zum Beispiel so:

Datei: `/opt/homer/homer-assets/config.yml`

```yaml
# /opt/homer/homer-assets/config.yml

title: "Mein Homelab"
subtitle: "Dashboard"
# theme: default   # weitere Themes siehe Homer-Dokumentation
# columns: "3"     # "auto" oder 1, 2, 3, 4, 6, 12

header: true
footer: false

services:
  - name: "Medien"
    icon: "fas fa-film"
    items:
      - name: "Jellyfin"
        logo: "assets/icons/jellyfin.png"
        subtitle: "Media-Server"
        tag: "medien"
        url: "http://192.168.1.10:8096"
        target: "_blank"

  - name: "Verwaltung"
    icon: "fas fa-cogs"
    items:
      - name: "Portainer"
        logo: "assets/icons/portainer.png"
        subtitle: "Docker-Management"
        url: "http://192.168.1.10:9000"
        target: "_blank"
        # Erreichbarkeit per HEAD-Request prüfen:
        type: "Ping"
```

Als Icons dienen lokale Bilddateien unter `homer-assets/icons/` oder Font-Awesome-Klassen wie `icon: "fas fa-server"`. Homer liest die `config.yml` beim Laden der Seite; nach dem Speichern genügt ein Neuladen im Browser, ein Container-Neustart ist nicht nötig.

> **Achtung:** **Wichtig:** Die `config.yml` ist unter `/assets/config.yml` für jeden abrufbar, der das Dashboard erreicht. Tragen Sie dort keine API-Schlüssel oder Passwörter ein, solange Homer nicht hinter einer Anmeldung liegt.

> **Prüfen:** Nach dem Neuladen (bei hartnäckigem Cache `Strg+Umschalt+R`) erscheinen Ihre Kacheln. Bei `type: "Ping"` zeigt Homer neben dem Dienst die Antwortzeit bzw. den Status an. Bleibt die Seite leer, prüfen Sie die Datei mit `yamllint homer-assets/config.yml`.

## Schritt 6: Updates und Backup

Für ein Update tragen Sie den neuen Tag aus den [Homer-Releases](https://github.com/bastienwirtz/homer/releases) in `compose.yaml` ein und führen aus:

```bash
$ cd /opt/homer
$ docker compose pull
$ docker compose up -d
```

Die `config.yml` und die Icons liegen im Bind-Mount und bleiben erhalten. Das Update von `v26.08.3` auf `v26.11.2` lief so ohne Änderung an der `config.yml`; danach meldete `docker compose ps` wieder `(healthy)`. Laut Release Notes nutzen seit v26.11.1 alle Dienst-Kacheln ein gemeinsames Layout. Laut Projektdokumentation greifen deshalb Selektoren wie `.media` oder `.media-content` in eigenen CSS-Dateien nicht mehr; das Symbol heißt jetzt `.card-icon`, Titel und Untertitel stehen in `.card-body`. Über neue Versionen informiert Sie Diun oder WUD, siehe [Docker-Container automatisch aktualisieren nach dem Watchtower-Aus](https://s-edv.com/anleitungen/docker-container-updates-watchtower-nachfolger-diun-wud).

**Backup:** Homer speichert keine weiteren Daten. Sichern Sie das Verzeichnis `/opt/homer/` mit `compose.yaml`, `.env` und `homer-assets/`.

> **Prüfen:** `docker compose images` zeigt den neuen Tag, `docker compose ps` den Status `Up`.

## Schritt 7: Reverse Proxy und HTTPS (optional)

Für eine eigene Domain mit TLS leiten Sie den Reverse Proxy auf `{{ip_1}}:8080` weiter; an Homer ist nichts zu ändern. Läuft Homer unter einem Unterverzeichnis wie `https://example.com/homer`, entfernen Sie in `compose.yaml` das Kommentarzeichen # vor der Zeile mit `SUBFOLDER=/homer` und starten neu mit `docker compose up -d`. Ohne diese Variable lädt der Browser CSS und JavaScript von falschen Pfaden.

Anleitungen: [Caddy als Reverse Proxy einrichten](https://s-edv.com/anleitungen/caddy-reverse-proxy-automatisches-https-anleitung) und [Traefik als Docker-Reverse-Proxy](https://s-edv.com/anleitungen/traefik-docker-reverse-proxy-https-einrichten).

> **Prüfen:** `curl -I https://homer.example.com` liefert Status 200, der Browser zeigt eine gültige Verbindung und die Konsole (F12) keine 404-Fehler.

## Troubleshooting / Typische Fehler

**Dashboard bleibt leer**

`config.yml` fehlt oder enthält einen YAML-Fehler, meist Tabs statt Leerzeichen. Prüfen Sie mit `docker compose logs homer` und `yamllint /opt/homer/homer-assets/config.yml`.

**`Assets directory not writable` im Log**

`homer-assets` ist für UID 1000 nicht schreibbar. Beheben mit `chown -R 1000:1000 /opt/homer/homer-assets`, dann `docker compose restart homer`.

**`Bind for 127.0.0.1:8080 failed: port is already allocated` beim Start**

Port 8080 ist belegt. Setzen Sie `HOMER_PORT` in der `.env` auf einen freien Port und starten Sie mit `docker compose up -d`.

**Dashboard im Heimnetz nicht erreichbar**

`HOMER_BIND` steht auf `{{ip_1}}`. Tragen Sie die LAN-Adresse des Hosts ein und starten Sie neu.

**Ping-Status zeigt „offline“, obwohl der Dienst läuft**

Der Browser blockiert die Anfrage, etwa bei HTTPS-Dashboard und HTTP-Dienst (Mixed Content) oder fehlenden CORS-Headern. Stellen Sie die Dienste per HTTPS unter derselben Domain bereit oder entfernen Sie `type: "Ping"`.

**CSS und JavaScript fehlen hinter dem Reverse Proxy**

`SUBFOLDER` ist nicht gesetzt, obwohl Homer unter einem Unterverzeichnis läuft (Schritt 7).

**Änderungen erscheinen nicht**

Der Browser zeigt die zwischengespeicherte Version (PWA-Cache). Laden Sie mit `Strg+Umschalt+R` bzw. `Cmd+Umschalt+R` neu.

## Häufige Fragen

### Muss ich den Container nach jeder Änderung an config.yml neu starten?

Nein. Homer liest die Datei beim Laden der Seite. Nach dem Speichern genügt ein Neuladen im Browser.

### Wie füge ich einen neuen Dienst zur Startseite hinzu?

Ergänzen Sie in `config.yml` unter `services` eine Gruppe oder unter `items` einen Eintrag mit `name` und `url`, optional `logo` oder `icon`, `subtitle` und `tag`.

### Wie aktiviere ich den Service-Status-Check?

Setzen Sie im Eintrag `type: "Ping"`. Homer sendet dann aus dem Browser einen HEAD-Request an die `url` und zeigt Status und Antwortzeit an; mit `method: "get"` und `successCodes` passen Sie die Prüfung an. Für Dienste wie Pi-hole oder AdGuard Home gibt es eigene Kartentypen mit Statistiken. Die Option `connectivityCheck` ist davon unabhängig: Sie prüft, ob das Dashboard selbst noch erreichbar ist, etwa bei einer VPN-Verbindung.

### Unterstützt Homer arm64 / Raspberry Pi 4 und 5?

Ja. Das Image steht auf Docker Hub für `linux/amd64`, `linux/arm64`, `linux/arm/v7` und `linux/arm/v6` bereit.

### Kann Homer hinter Nginx, Traefik oder Caddy betrieben werden?

Ja. Unter einer eigenen Subdomain ist keine Anpassung nötig. Unter einem Unterverzeichnis setzen Sie `SUBFOLDER` in `compose.yaml` (Schritt 7).

### Wo finde ich fertige Logos und Icons für meine Dienste?

Nutzen Sie Font-Awesome-Klassen direkt in der YAML oder legen Sie PNG- bzw. SVG-Logos der Projekte unter `homer-assets/icons/` ab und verweisen mit `logo: "assets/icons/dienst.png"` darauf. Das Projekt [dashboard-icons](https://github.com/homarr-labs/dashboard-icons) sammelt Logos gängiger Self-Hosting-Dienste.

## Fazit

Homer liefert mit einem Container von rund 25 MB und einer YAML-Datei eine schnelle Startseite für alle selbst gehosteten Dienste. Binden Sie den Port gezielt an eine Adresse, legen Sie den Image-Tag fest und halten Sie Zugangsdaten aus der `config.yml` heraus. Brauchen Sie Widgets und Integrationen, bietet [Homepage](https://s-edv.com/anleitungen/homepage-synology-dashboard-selfhosting) mehr Funktionen; für reine Statusüberwachung eignet sich [Gatus](https://s-edv.com/anleitungen/gatus-docker-status-dashboard).

## Weiterführende Anleitungen und Quellen

1. [Docker und Docker Compose auf Linux installieren: die Self-Hosting-Grundlage](https://s-edv.com/anleitungen/docker-compose-linux-selfhosting-grundlage)
2. [Docker-Container automatisch aktualisieren nach dem Watchtower-Aus: Diun, WUD und Renovate](https://s-edv.com/anleitungen/docker-container-updates-watchtower-nachfolger-diun-wud)
3. [Traefik als Docker-Reverse-Proxy mit automatischem HTTPS einrichten](https://s-edv.com/anleitungen/traefik-docker-reverse-proxy-https-einrichten)
4. [Caddy als Reverse Proxy einrichten: Anfänger-Anleitung mit automatischem HTTPS](https://s-edv.com/anleitungen/caddy-reverse-proxy-automatisches-https-anleitung)
5. [Homepage auf dem Synology NAS installieren: Dashboard für alle Self-Hosting-Dienste](https://s-edv.com/anleitungen/homepage-synology-dashboard-selfhosting)
6. [Gatus mit Docker installieren: entwicklerorientiertes Status-Dashboard](https://s-edv.com/anleitungen/gatus-docker-status-dashboard)

Offizielle Quellen: [Homer GitHub Repository](https://github.com/bastienwirtz/homer) (bastienwirtz/homer) · [b4bz/homer auf Docker Hub](https://hub.docker.com/r/b4bz/homer) · [Homer Konfigurationsdokumentation](https://github.com/bastienwirtz/homer/blob/main/docs/configuration.md)

## Passende Anleitungen auf S-EDV

1. [Automatische Sicherheitsupdates unter Debian/Ubuntu mit unattended-upgrades rich](https://s-edv.com/anleitungen/unattended-upgrades-automatische-sicherheitsupdates-debian-ubuntu)
2. [netcup Local Block Storage bestellen, einrichten und unter Linux einbinden](https://s-edv.com/anleitungen/netcup-local-block-storage-bestellen-linux-einbinden)
