Home Assistant

Home Assistant ist die zentrale Plattform für Smart Home Automation. Du kannst es entweder als komplettes Betriebssystem in einer Virtual Machine (VM) oder als Docker-Container installieren.

---

1. Methode A: Home Assistant OS (VirtualBox)

Diese Methode bietet den vollen Funktionsumfang inklusive Add-ons[cite: 1].

Voraussetzungen & Download

• Images: Lade die passende Datei herunter und entpacke sie (z. B. .vdi für VirtualBox)[cite: 2].
• Ressourcen: Weise der VM mindestens 2 GB RAM und 2 vCPUs zu.

Einrichtung in VirtualBox

1. VM erstellen: Wähle als Typ Linux und die Version Oracle Linux (64-bit).
2. Hardware: Aktiviere unbedingt die Option Enable EFI in den Hardware-Einstellungen.
3. Speicher:
   • Entferne die leere Standard-Festplatte unter Controller: SATA.
   • Füge die heruntergeladene .vdi-Datei als neue Festplatte hinzu.
4. Netzwerk: Ändere den Modus von NAT auf Bridged Adapter, damit Home Assistant andere Geräte in deinem Haus findet.

Start & Zugriff

Starte die VM. Sobald der Boot-Vorgang abgeschlossen ist, erreichst du die Oberfläche unter: [http://homeassistant.local:8123](http://homeassistant.local:8123).

---

2. Methode B: Home Assistant Container (Docker)

Diese Methode ist ideal, wenn du bereits eine bestehende Docker-Umgebung verwaltest. Hinweis: Diese Version unterstützt keine Add-ons.

Installation via Docker CLI

Ersetze die Platzhalter für deine Pfade und Zeitzone:

docker run -d \
  --name homeassistant \
  --privileged \
  --restart=unless-stopped \
  -e TZ=Europe/Berlin \
  -v /DEIN/PFAD/ZUR/CONFIG:/config \
  -v /run/dbus:/run/dbus:ro \
  --network=host \
  ghcr.io/home-assistant/home-assistant:stable

Installation via Docker Compose

Erstelle eine compose.yaml für eine einfachere Verwaltung:

services:
  homeassistant:
    container_name: homeassistant
    image: "ghcr.io/home-assistant/home-assistant:stable"
    volumes:
      - /DEIN/PFAD/ZUR/CONFIG:/config
      - /etc/localtime:/etc/localtime:ro
      - /run/dbus:/run/dbus:ro
    restart: unless-stopped
    privileged: true
    network_mode: host
    environment:
      TZ: Europe/Berlin

Starte den Container mit: docker compose up -d.

---

3. Erweiterte Konfiguration & Troubleshooting

Hardware-Zugriff (z. B. Zigbee-Sticks)

Um USB-Geräte in den Container durchzureichen, musst du das Gerät mappen:

• CLI: --device /dev/ttyUSB0:/dev/ttyUSB0
• Stelle sicher, dass der User im System die nötigen Rechte für /dev/tty* besitzt.

Neustart des Systems

Bei Änderungen an der Konfiguration kannst du Home Assistant wie folgt neu starten:

1. UI: Einstellungen > System > Menü (drei Punkte) > Neustart.
2. Terminal: docker restart homeassistant.

Kein Zugriff auf die Oberfläche?

Falls die Seite nicht lädt, blockiert oft die Linux-Firewall den Port 8123.

• Lösung (z. B. Debian/UFW): sudo ufw allow 8123/tcp.

---

4. Zusammenfassung: Welche Methode wählen?

Feature	Home Assistant OS (VM)	Home Assistant Container
Add-ons	Ja (integrierter Shop)	Nein (manuelle Container nötig)
Management	Komplett via UI	Manuell via Docker/CLI
Ressourcen	Höher (VM Overhead)	Sehr effizient
Empfehlung	Einsteiger & Smart-Home Fokus	Erfahrene Docker-Nutzer