HomeAssistant mit HAOS in Proxmox einrichten

Die Installation von Home Assistant Operating System (HAOS) auf Proxmox VE als virtuelle Maschine (VM) gilt als der Goldstandard für ein flexibles Smart Home. Du erhältst damit die volle Funktionalität von HAOS (inklusive Add-on-Store, Supervisor und automatischen Updates), während du gleichzeitig Schnappschüsse (Snapshots) und Backups des gesamten Systems in Proxmox erstellen kannst.

Der eleganteste Weg zur Installation führt über die Proxmox VE Helper-Scripts der Community.

Was ist Proxmox VE?

Proxmox Virtual Environment (PVE) ist eine quelloffene (Open-Source) Plattform für Server-Virtualisierung. Sie basiert auf Debian Linux und nutzt KVM (Kernel-based Virtual Machine) für vollwertige virtuelle Maschinen sowie LXC für leichtgewichtige Container.

Kurz gesagt: Proxmox erlaubt es dir, auf einer einzigen physischen Hardware mehrere unabhängige Betriebssysteme parallel zu betreiben. Für Home Assistant ist das ideal, weil HAOS als isolierte VM mit eigenen Ressourcen läuft und du über Proxmox jederzeit schnelle Sicherungspunkte (Snapshots) oder Backups deines gesamten Smart Homes erstellen kannst.

Was ist Home Assistant OS (HAOS)?

Home Assistant Operating System (HAOS) ist ein speziell entwickeltes, minimales Linux-Betriebssystem, das aus einer Hardware oder einer virtuellen Maschine ein dediziertes Smart-Home-Steuergerät („Appliance“) macht.

Im Gegensatz zu einer reinen Software-Installation verwaltet HAOS das gesamte System selbstständig. Der größte Vorteil von HAOS ist der integrierte Supervisor: Er ermöglicht die Installation von Erweiterungen (Add-ons) wie Zigbee2MQTT, Node-RED, Mosquitto Broker oder ESPHome mit nur einem Klick direkt aus der Home-Assistant-Oberfläche.

Darüber hinaus kümmert sich HAOS automatisch um Betriebssystem- und Core-Updates, bietet ein nahtloses Backup-System für das Gesamtsystem und sorgt für eine einfache Anbindung von Smart-Home-Hardware (wie USB-Zigbee-Sticks). Es ist die von den Entwicklern empfohlene Installationsmethode für den wartungsarmen und stabilen Betrieb.

Voraussetzungen

  • Ein einsatzbereiter Proxmox VE Host (empfohlen: Proxmox VE 8.x)
  • Zugewiesener Speicherplatz auf dem Proxmox-Node (mind. 32 GB NVMe/SSD empfohlen)
  • Internetverbindung des Proxmox-Hosts zum Herunterladen des HAOS-Images

Installation

Proxmox Shell öffnen

Zugriff auf die Node-Konsole.

  1. Melde dich im Web-Interface deines Proxmox VE Servers an (https://<PROXMOX-IP>:8006).
  2. Wähle im linken Menübaum deinen Node (z. B. pve) aus.
  3. Klicke im Menü oben rechts oder in der Seitennavigation auf >_ Shell.

Helper-Script starten

Führt den automatischen VM-Builder aus – Kopiere folgenden Befehl, füge ihn in die Proxmox-Shell ein und drücke Enter:

Bash

bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/vm/haos-vm.sh)"

Hinweis: Das Skript stammt aus dem etablierten Open-Source-Projekt Proxmox VE Helper-Scripts (Community Edition).

Installations-Assistent durchlaufen

Ressourcen und Einstellungen definieren.

Das Skript führt dich durch ein interaktives Menü:

  1. Bestätige die Abfrage „Create a Home Assistant OS VM?“ mit Yes (Enter).
  2. Wähle zwischen [Default] und [Advanced]:
    • Default Settings (empfohlen): Erstellt automatisch eine VM mit 2 CPU-Kernen, 4 GB RAM, 32 GB Speicherplatz und UEFI-Bios.
    • Advanced Settings: Ermöglicht die Anpassung von VM-ID, CPU-Kernen, RAM, Storage-Pool und VLANs.
  3. Das Skript lädt nun das neueste offizielle HAOS-KVM-Image herunter, konfiguriert die VM und startet sie automatisch.

Hardware an VM durchreichen

USB-Passthrough für Zigbee-, Z-Wave- oder Bluetooth-Sticks.

Falls du USB-Hardware (z. B. Sonoff Zigbee Dongle, ConBee II, Z-Wave-Stick) nutzt:

  1. Wähle die neu erstellte HomeAssistant VM in Proxmox aus.
  2. Gehe auf Hardware ➔ Hinzufügen ➔ USB-Gerät.
  3. Wähle „USB-Hersteller/Geräte-ID nutzen“ oder „USB-Port nutzen“ und wähle deinen Stick aus.
  4. Klicke auf Hinzufügen. Der Stick wird direkt in HAOS verfügbar.

HomeAssistant einrichten

Jetzt kann die Einrichtung von HomeAssistant wie gewoht über das Webinterface erfolgen. Die IP Adresse kann man leicht über die Console erfahren.

Wichtige Proxmox-Tipps für HomeAssistant

  • Snapshots vor Updates: Erstelle vor größeren HomeAssistant-Updates in Proxmox unter VM ➔ Snapshots einen Wiederherstellungspunkt. Bei Problemen kannst du das gesamte System innerhalb weniger Sekunden zurückrollen.
  • Proxmox Backups (PBS oder Lokal): Richte unter Datacenter ➔ Backup einen automatischen Zeitplan ein (z. B. 1x wöchentlich nachts), um die gesamte VM im laufenden Betrieb extern zu sichern.
  • Feste IP-Adresse: Vergebe im Router (z. B. FRITZ!Box) eine feste IP-Adresse für die MAC-Adresse der VM, damit Home Assistant im Netzwerk immer unter derselben Adresse erreichbar bleibt.

Bilder