← Anleitungen
Smart Home & IoT-PlattformenFortgeschritten4 Min

Home Assistant

Home Assistant ist die offene Zentrale fürs Smart Home: Sie verbindet tausende Geräte herstellerübergreifend, läuft komplett lokal und automatisiert deine Gebäudetechnik per Web-UI.

Wer sein Smart Home wirklich selbst kontrollieren möchte, kommt an Home Assistant kaum vorbei. Die quelloffene Plattform bündelt Lampen, Sensoren, Heizungen, Kameras und tausende weitere Geräte unter einer einzigen Oberfläche – und das vollständig lokal, ohne Zwang zur Cloud des jeweiligen Herstellers. Genau diese Datenhoheit macht Home Assistant für ambitionierte Heimanwender wie auch für die Gebäudeautomation interessant. In dieser Anleitung erfährst du, was Home Assistant ausmacht, wofür es sich eignet und wie du es sauber als Docker-Container mit persistenter Konfiguration betreibst.

Was ist Home Assistant?

Home Assistant ist eine quelloffene Plattform für Heimautomatisierung, die als zentrale Schaltstelle zwischen all deinen smarten Geräten dient. Statt für jede Lampe, jeden Sensor und jede Steuerung eine eigene Hersteller-App zu öffnen, fasst Home Assistant alles in einer einheitlichen Web-Oberfläche zusammen und lässt dich Geräte verschiedenster Ökosysteme miteinander verknüpfen. Der entscheidende Unterschied zu vielen kommerziellen Lösungen: Home Assistant läuft lokal auf deiner eigenen Hardware, verarbeitet die Daten im eigenen Netz und funktioniert auch dann weiter, wenn die Internet-Verbindung oder ein Hersteller-Dienst ausfällt.

Wofür eignet sich Home Assistant?

Geräte-Integration über Hersteller hinweg. Mit über tausend Integrationen bindest du Zigbee, Z-Wave, WLAN- und Matter-Geräte sowie Cloud-Dienste ein und steuerst sie gemeinsam – auch wenn sie von völlig unterschiedlichen Anbietern stammen.

Automatisierungen und Szenen. Du definierst Regeln nach dem Muster Auslöser, Bedingung und Aktion: Licht bei Bewegung, Heizung nach Anwesenheit, Rollläden nach Sonnenstand. So wird aus Einzelgeräten echte Gebäudeautomation.

Lokale Datenhoheit. Sensordaten, Kamerabilder und Steuerbefehle bleiben standardmässig im eigenen Netz. Das ist besonders relevant, wenn Datenschutz oder die Unabhängigkeit von externen Cloud-Diensten Priorität haben.

Dashboards und Visualisierung. Anpassbare Dashboards zeigen den Zustand deines Hauses übersichtlich an – vom Energieverbrauch über Raumtemperaturen bis zum Status von Türen und Fenstern.

Wichtige Konzepte und Stärken

Entitäten und Geräte. Jedes physische Gerät stellt eine oder mehrere Entitäten bereit (z. B. Schalter, Temperatur, Helligkeit). Entitäten sind die Bausteine, auf die Dashboards und Automatisierungen zugreifen.

Add-ons vs. Container. Das komfortable Add-on-System (etwa für Mosquitto-MQTT oder Zigbee2MQTT) steht nur bei der Betriebssystem-Installation (Home Assistant OS / Supervised) zur Verfügung. Im reinen Docker-Container (Home Assistant Container) betreibst du solche Zusatzdienste als eigene Container daneben.

Abhängigkeit von Zusatzdiensten. Für Funk-Geräte brauchst du meist einen Unterbau: Zigbee2MQTT setzt einen MQTT-Broker wie Mosquitto voraus (Z-Wave JS bzw. die ZHA-Integration kommen auch ohne MQTT aus). Plane diese Dienste von Anfang an mit ein, wenn du Funk-Hardware einsetzen willst.

Erweiterbarkeit. Über YAML-Konfiguration, Templates und die Community-Erweiterung HACS lässt sich nahezu jedes Verhalten anpassen – Home Assistant skaliert vom Einzelgerät bis zur kompletten Hausautomation.

Das Verzeichnis /config enthält deine gesamte Konfiguration, Automatisierungen, Verlaufsdaten und Geheimnisse. Es MUSS über ein benanntes Volume persistiert werden – ohne Persistenz ist nach einem Container-Neustart oder Update alles verloren.

Installation mit Docker

Wir verwenden das offizielle Image ghcr.io/home-assistant/home-assistant:stable. Persistent muss zwingend das Verzeichnis /config sein – dort liegen configuration.yaml, deine Automatisierungen, der Geräte-Cache, die Verlaufsdatenbank und die Secrets. Wir binden es deshalb über ein benanntes Volume (ha_config) ein, nicht über ein anonymes Volume. Die offizielle Doku empfiehlt für Home Assistant Container ausdrücklich network_mode: host (damit Discovery, mDNS und viele Integrationen zuverlässig funktionieren) sowie privileged: true (für den Zugriff auf Host-Hardware wie Bluetooth- oder USB-Adapter). Achtung: Im Host-Netzwerk-Modus wird kein Port-Mapping verwendet – Home Assistant ist direkt unter Port 8123 des Hosts erreichbar. Reichst du einen Zigbee-/Z-Wave-Stick durch, ergänzt du zusätzlich ein Geräte-Mapping (devices).

1docker run -d \
2 --name homeassistant \
3 --restart=unless-stopped \
4 --privileged \
5 --network=host \
6 -e TZ=Europe/Zurich \
7 -v ha_config:/config \
8 -v /etc/localtime:/etc/localtime:ro \
9 -v /run/dbus:/run/dbus:ro \
10 ghcr.io/home-assistant/home-assistant:stable

Oder als wiederverwendbare docker-compose.yml:

1services:
2 homeassistant:
3 image: ghcr.io/home-assistant/home-assistant:stable
4 container_name: homeassistant
5 restart: unless-stopped
6 privileged: true
7 network_mode: host
8 environment:
9 - TZ=Europe/Zurich
10 volumes:
11 - ha_config:/config
12 - /etc/localtime:/etc/localtime:ro
13 - /run/dbus:/run/dbus:ro
14 # Optional fuer USB-Sticks (Zigbee/Z-Wave):
15 # devices:
16 # - /dev/ttyUSB0:/dev/ttyUSB0
17
18volumes:
19 ha_config:

privileged gibt dem Container weitreichende Rechte am Host; die offizielle Doku setzt es für Home Assistant Container dennoch standardmaessig, weil im Host-Netzwerk-Modus Hardware- und Bluetooth-Zugriff darauf angewiesen sind. Wenn du sicher weisst, dass du keine lokale Hardware brauchst, kannst du privileged weglassen. Den Device-Eintrag (devices) ergaenzt du nur, wenn du wirklich einen USB-Stick durchreichst. Sichere ausserdem das Volume ha_config regelmaessig, denn es enthaelt neben der Konfiguration auch deine Secrets und die komplette Verlaufsdatenbank.

Nach dem Start läuft die Web-UI auf Port 8123. Prüfe zuerst die Logs und öffne dann im Browser das Onboarding:

1docker logs -f homeassistant
2# Danach im Browser oeffnen und dem Onboarding folgen:
3# http://SERVER-IP:8123

Fazit

Home Assistant ist die wohl mächtigste offene Lösung für Smart Home und Gebäudeautomation: herstellerneutral, vollständig lokal und nahezu beliebig erweiterbar. Mit dem offiziellen Container und einem persistenten Volume für /config hast du in wenigen Minuten eine solide Basis, auf der du Schritt für Schritt Geräte, Dashboards und Automatisierungen aufbaust. Wer Funk-Geräte einbinden will, plant von Beginn an die nötigen Zusatzdienste (etwa einen MQTT-Broker für Zigbee2MQTT) mit ein – dann steht einer souveränen, selbst gehosteten Hausautomation nichts im Weg.