Deployn

Home Assistant mit Docker auf dem Raspberry Pi installieren

Home Assistant mit Docker auf dem Raspberry Pi installieren. Anleitung für ein privates, leistungsstarkes Smart Home – vollständige Kontrolle über deine Daten!

Auf YouTube ansehen
Home Assistant mit Docker auf dem Raspberry Pi installieren hero image
Inhalt

Du möchtest dein Zuhause automatisieren, aber die Kontrolle über deine Daten nicht an große Unternehmen abgeben? Dann ist Home Assistant die perfekte Lösung für dich. Es ist eine extrem leistungsstarke, flexible und vor allem private Open-Source-Plattform für dein Smart Home.

In dieser Anleitung zeige ich dir, wie du Home Assistant ganz einfach mit Docker auf einem Server wie dem Raspberry Pi installierst. Wir verzichten auf fertige Systeme und behalten die volle Kontrolle.

Was ist Home Assistant?

Home Assistant ist eine Open-Source-Plattform, die als zentrale Steuerungseinheit für dein Smart Home dient. Anstatt Dutzende verschiedener Apps für Lampen, Steckdosen, Thermostate und Sensoren zu nutzen, bündelt Home Assistant alles in einer einzigen, übersichtlichen Oberfläche. Der größte Vorteil: Es läuft lokal bei dir zu Hause, zum Beispiel auf einem Raspberry Pi. Deine Daten bleiben bei dir und werden nicht in eine fremde Cloud gesendet.

Die Plattform ist vielseitig und unterstützt Tausende von Geräten verschiedenster Hersteller. Über Automatisierungen kannst du intelligente Abläufe erstellen – schalte zum Beispiel das Licht ein, wenn du nach Hause kommst, oder fahre die Heizung herunter, wenn das Fenster geöffnet wird.

Home Assistant OS vs. Docker-Container: Welcher Weg ist der richtige?

Es gibt verschiedene Wege, Home Assistant zu installieren. Die offizielle Dokumentation unterscheidet hauptsächlich zwischen zwei Methoden:

Methode Beschreibung Vorteile Nachteile
Home Assistant OS Ein komplettes Betriebssystem, das speziell für Home Assistant entwickelt wurde. Ideal für Einsteiger und den Betrieb auf dedizierter Hardware wie einem Raspberry Pi oder dem Home Assistant Green. Einfache Installation, One-Click-Updates, integrierter Add-on-Store für Dienste wie AdGuard oder MariaDB. Weniger Flexibilität, da das Betriebssystem für einen einzigen Zweck optimiert ist.
Home Assistant Container Eine reine Docker-Installation von Home Assistant auf einem bestehenden Linux-System. Dies ist der Weg, den wir in dieser Anleitung gehen. Maximale Kontrolle und Flexibilität. Du kannst den Server auch für andere Dienste nutzen. “Add-ons” können einfach als separate Docker-Container verwaltet werden. Updates und die Verwaltung von Zusatzdiensten erfordern etwas mehr manuelle Arbeit.

Wir entscheiden uns für die Container-Methode, weil sie uns die volle Kontrolle gibt. Add-ons wie eine Datenbank können wir bei Bedarf einfach als eigenen Container hinzufügen, und Updates sind mit zwei Befehlen erledigt.

Voraussetzungen: Was du benötigst

Um loszulegen, brauchst du nicht viel. Den Home Assistant Green für 99 € können wir uns sparen.

  • Ein Server: Ein Raspberry Pi (Amazon Affiliate-Link) (Modell 4 oder neuer ist empfohlen) ist eine beliebte und energieeffiziente Wahl. Aber auch ein alter Laptop, ein Intel NUC oder ein NAS mit Linux als Betriebssystem sind perfekt geeignet.
  • Docker: Auf deinem Server muss Docker installiert sein. Wie du Docker auf einem Raspberry Pi einrichtest, zeige ich in einem meiner anderen Blogposts.
  • Smart-Home-Geräte: Natürlich benötigst du auch ein paar intelligente Geräte, die du steuern möchtest, z. B. Lampen (Philips Hue (Amazon Affiliate-Link)), Steckdosen (Shelly (Amazon Affiliate-Link)), Thermostate oder Sensoren.

Die Befehle in diesem Beitrag tippst du in ein Terminal. Falls dir cd, mkdir oder nano nichts sagen, hilft dir Linux-Terminal für Anfänger. Zehn Minuten dort reichen für alles, was du hier brauchst.

Was ist Docker in einem Satz? Docker startet ein Programm in einem abgeschlossenen „Container“. Alles, was Home Assistant zum Laufen braucht, steckt schon drin, und du musst nichts einzeln auf deinem System installieren. Beschrieben wird der Container in einer kleinen Textdatei, der compose.yaml. Genau diese Datei legen wir gleich an.

Installation: Schritt-für-Schritt zum eigenen Smart Home

Folge einfach diesen Schritten, um Home Assistant in wenigen Minuten auf deinem Server zum Laufen zu bringen.

1. Mit dem Server verbinden und Ordner anlegen

Zuerst verbinden wir uns per SSH mit unserem Server (in meinem Fall ein Raspberry Pi). SSH ist eine verschlüsselte Fernsteuerung: Du tippst Befehle an deinem normalen Computer, ausgeführt werden sie auf dem Server.

Terminalbash
ssh benutzername@ip-adresse-deines-servers

Ersetze benutzername durch den Namen, den du bei der Einrichtung des Servers vergeben hast, und die IP-Adresse durch die deines Servers. Die findest du meist in der Geräteliste deines Routers (bei einer Fritz!Box unter „Heimnetz > Netzwerk“) oder direkt auf dem Pi mit hostname -I. Beim ersten Verbinden fragt SSH, ob du dem Server vertraust. Antworte mit yes und gib dann dein Passwort ein. Das Passwort bleibt beim Tippen unsichtbar, das ist normal.

Sobald du verbunden bist, erstellen wir die notwendige Ordnerstruktur für Home Assistant.

Terminalbash
# Einen Hauptordner für Home Assistant erstellen
mkdir homeassistant

# In den neuen Ordner wechseln
cd homeassistant

# Einen Unterordner für die Konfiguration anlegen
mkdir config

# Eine leere Docker Compose Datei erstellen
touch compose.yaml

Jetzt haben wir im Verzeichnis homeassistant einen config-Ordner, in dem alle Einstellungen gespeichert werden, und eine compose.yaml-Datei, die unsere Docker-Konfiguration enthält.

2. Die compose.yaml erstellen

Öffne die compose.yaml-Datei mit einem Texteditor wie nano.

Terminalbash
nano compose.yaml

Füge nun folgenden Inhalt ein. Ich erkläre dir gleich, was die einzelnen Zeilen bedeuten. Achte auf die Einrückungen: YAML nutzt Leerzeichen zur Gliederung, und ein falscher Einzug führt zu einer Fehlermeldung. Am sichersten kopierst du den Block komplett.

yaml
services:
    homeassistant:
        image: ghcr.io/home-assistant/home-assistant:2026.11
        container_name: homeassistant
        network_mode: host
        volumes:
            - ./config:/config
            - /etc/localtime:/etc/localtime:ro
            - /run/dbus:/run/dbus:ro # Optional für Bluetooth
        # Hier kannst du USB-Geräte wie Zigbee-Sticks durchreichen
        # devices:
        #     - /dev/ttyUSB0:/dev/ttyUSB0
        restart: unless-stopped
        privileged: true
        environment:
            - TZ=Europe/Berlin

Was bedeuten die einzelnen Konfigurationen?

  • image: Wir verwenden das offizielle Image von der GitHub Container Registry (ghcr.io). Wichtig: Ich gebe hier eine feste Version an (2026.11, Stand November 2026), anstatt latest zu verwenden. So vermeiden wir unerwartete Probleme nach automatischen Updates und können gezielt aktualisieren.
  • container_name: Ein fester Name, der die Verwaltung des Containers erleichtert.
  • network_mode: host: Erlaubt Home Assistant, die Netzwerkschnittstelle deines Servers direkt zu nutzen. Das ist entscheidend für die automatische Erkennung vieler Geräte im Netzwerk.
  • volumes: Wir binden unseren lokalen config-Ordner in den Container ein. So bleiben alle unsere Einstellungen auch nach einem Update erhalten. Zusätzlich synchronisieren wir die Systemzeit.
  • devices: Diese Zeilen sind auskommentiert (das # davor), werden aber wichtig, wenn du Hardware wie einen Zigbee- oder Z-Wave-Stick per USB anschließt.
  • restart: unless-stopped: Sorgt dafür, dass der Container automatisch startet, falls dein Server einmal neu gestartet wird.
  • privileged: true: Gibt dem Container erweiterte Rechte. Dies ist oft notwendig, um auf Hardware wie USB-Geräte zugreifen zu können.
  • environment: Hier legen wir die Zeitzone fest, damit alle Zeitangaben und Automatisierungen korrekt funktionieren.

Speichere die Datei mit Strg + X, bestätige mit Y und drücke Enter.

3. Home Assistant starten

Jetzt ist alles bereit. Mit einem einzigen Befehl starten wir Home Assistant:

Terminalbash
sudo docker compose up -d

Führe den Befehl im Ordner homeassistant aus, dort liegt die compose.yaml. Docker lädt nun das Home Assistant Image herunter (das „Image“ ist die fertige Programmvorlage) und startet daraus den Container im Hintergrund (-d steht für “detached”). Der erste Start kann einige Minuten dauern, während Home Assistant sich initialisiert.

Ob der Container läuft, siehst du mit:

Terminalbash
sudo docker compose ps

In der Spalte STATUS sollte Up stehen. Den Fortschritt beim Start beobachtest du mit folgendem Befehl (mit Strg + C beendest du die Anzeige, der Container läuft weiter):

Terminalbash
sudo docker compose logs -f

Wenn du keine Fehlermeldungen siehst, ist alles auf einem guten Weg.

Meldet Docker command not found oder unknown shorthand flag, ist Docker oder das Compose-Plugin nicht installiert. Gehe dann zurück zu den Voraussetzungen oben.

Die Ersteinrichtung

Öffne einen Webbrowser und gib die IP-Adresse deines Servers gefolgt vom Port 8123 ein:

http://DEINE-SERVER-IP:8123

Du solltest vom Home Assistant Willkommensbildschirm begrüßt werden.

  1. Benutzerkonto erstellen: Klicke auf „Mein Smart Home erstellen“ und lege einen Administrator-Account mit Namen und einem sicheren Passwort an.
  2. Standort festlegen: Gib deinen Standort an. Dies hilft Home Assistant, genaue Sonnenauf- und -untergangszeiten für Automatisierungen zu berechnen.
  3. Analyse-Daten: Entscheide, ob du anonyme Nutzungsdaten teilen möchtest.

Anschließend sucht Home Assistant dein Netzwerk nach kompatiblen Geräten ab.

Geräte integrieren und das Dashboard erkunden

Nach der Einrichtung landest du auf deinem persönlichen Dashboard. Hier siehst du bereits erste Informationen wie das Wetter und die von dir eingerichteten Geräte.

Um weitere Geräte hinzuzufügen, gehe zu Einstellungen > Geräte & Dienste.

Hier kannst du über den Button „Integration hinzufügen“ nach hunderten von unterstützten Diensten und Geräten suchen.

Beispiel: Eine Shelly-Steckdose hinzufügen

In meinem Fall kann ich meine Shelly-Steckdose hinzufügen. Nach der Konfiguration erscheint sie direkt auf meinem Dashboard. Ich kann sie jetzt nicht nur ein- und ausschalten, sondern sehe auch den aktuellen Stromverbrauch in Echtzeit.

So kannst du nach und nach alle deine Geräte hinzufügen und dein Dashboard nach deinen Wünschen anpassen.

So einfach ist ein Update

  1. Version ändern: Öffne erneut die compose.yaml-Datei auf deinem Server.

    Terminalbash
    nano compose.yaml

    Ändere die Zeile image: ghcr.io/home-assistant/home-assistant:2026.11 auf die neuere Version. Welche es gibt, siehst du in den Release-Hinweisen von Home Assistant. Lies dort kurz die „Breaking changes“, bevor du aktualisierst.

  2. Container stoppen: Beende den laufenden Home Assistant Container.

    Terminalbash
    sudo docker compose down
  3. Neues Image herunterladen: Lade die neue Version herunter.

    Terminalbash
    sudo docker compose pull
  4. Container neu starten: Starte Home Assistant mit der neuen Version.

    Terminalbash
    sudo docker compose up -d

Das war’s schon! Gehe in der Weboberfläche zu Einstellungen > Über, um zu überprüfen, ob die neue Version läuft. Der ganze Prozess dauert nur wenige Minuten.

Fazit: Dein Smart Home, deine Regeln

Wir haben gesehen, wie einfach es ist, Home Assistant mit Docker auf einem Raspberry Pi zu installieren. Du hast jetzt eine private Basis für dein Smart Home geschaffen.

Der nächste Schritt ist, deine Geräte zu integrieren und die Welt der Automatisierungen zu entdecken. Erstelle Szenen, Skripte und Regeln, die dein Zuhause wirklich intelligent machen. Schreib gerne in die Kommentare, welche Automatisierung für dich am nützlichsten ist!

Häufige Fragen

Was ist Home Assistant und wie funktioniert es?

Home Assistant ist eine Open-Source-Plattform, die als zentrale Steuerung für alle deine Smart-Home-Geräte dient. Es läuft lokal auf deinem eigenen Server (z.B. einem Raspberry Pi) und kommuniziert direkt mit deinen Geräten, ohne auf die Cloud der Hersteller angewiesen zu sein.

Welche Hardware benötige ich für den Start?

Du benötigst einen kleinen Server, auf dem Docker läuft. Ein Raspberry Pi 4 (oder neuer) mit mindestens 2 GB RAM ist eine ausgezeichnete Wahl. Alternativ funktionieren auch andere Linux-Server, ein Intel NUC oder ein NAS.

Warum sollte ich die Docker-Methode anstelle des Home Assistant OS verwenden?

Die Docker-Methode bietet dir maximale Flexibilität. Du kannst deinen Server gleichzeitig für andere Anwendungen nutzen und hast die volle Kontrolle über Updates und Systemkonfigurationen. Sie ist ideal für Nutzer, die bereits mit Docker vertraut sind oder es lernen möchten.

Wie verbinde ich Geräte wie Lampen oder Sensoren?

Die meisten WLAN-Geräte werden automatisch im Netzwerk erkannt. Für andere Protokolle wie Zigbee oder Z-Wave benötigst du einen entsprechenden USB-Stick, den du in deiner compose.yaml-Datei an den Container durchreichst. Anschließend kannst du die Geräte über die jeweilige Integration in den Einstellungen hinzufügen.

Wie erstelle ich automatisierte Abläufe?

Unter Einstellungen > Automatisierungen & Szenen findest du einen benutzerfreundlichen Editor. Hier kannst du Auslöser (z. B. 'Bewegung im Flur erkannt'), Bedingungen (z. B. 'nur zwischen 22:00 und 06:00 Uhr') und Aktionen (z. B. 'schalte Flurlicht auf 20% Helligkeit') festlegen.

Ist Home Assistant sicher?

Da Home Assistant lokal läuft, hast du die Kontrolle über deine Daten. Es ist wichtig, dein System mit starken Passwörtern abzusichern, regelmäßige Updates durchzuführen und den Zugriff aus dem Internet nur über sichere Methoden wie eine VPN-Verbindung oder einen Reverse-Proxy mit Verschlüsselung zu erlauben.

Als Amazon-Partner verdiene ich an qualifizierten Verkäufen.