Homeserver-Kompass

StartAnleitungen

Home Assistant auf Proxmox installieren: HAOS als VM einrichten

Home Assistant OS als virtuelle Maschine unter Proxmox VE 9: VM anlegen, qcow2-Abbild importieren, UEFI richtig einstellen, Zigbee-Stick durchreichen.

Art
Anleitungen
Datum
Bearbeiter
Mark Klauser

Enthält Werbelinks, markiert mit *. Kaufst du darüber, erhalte ich eine Provision von Amazon. Der Preis bleibt für dich gleich, die Empfehlungen beeinflusst das nicht.

Kurz gesagt

Lege in Proxmox eine VM ohne Installationsmedium an, mit UEFI (OVMF) ohne vorab eingetragene Secure-Boot-Schlüssel, mindestens 2 vCPUs und 2 GB RAM, und lösche die vorgeschlagene Festplatte. Lade in der Shell das KVM-Abbild von Home Assistant herunter, entpacke es und importiere es mit qm disk import in die VM. Danach die Platte einhängen, als erstes Startlaufwerk setzen und die VM starten. Home Assistant erreichst du dann unter Port 8123.

Home Assistant OS läuft unter Proxmox als eigene virtuelle Maschine. Das Home-Assistant-Team stellt dafür ein fertiges Abbild im Format qcow2 bereit, du musst also nichts installieren, nur importieren. Die VM bekommt die volle Home-Assistant-Ausstattung mit Add-ons und Updates per Mausklick. Diese Anleitung bezieht sich auf Proxmox VE 9.2 und Home Assistant OS 18.4, die aktuellen Versionen im November 2026.

Was du brauchst

  • Einen Rechner mit installiertem Proxmox VE. Falls noch nicht geschehen: Proxmox installieren.
  • Für die VM laut Home Assistant mindestens 2 GB RAM und 2 virtuelle CPUs. Mit mehreren Add-ons sind 4 GB eine gute Größe.
  • Etwa 32 GB Platz auf dem Proxmox-Speicher. Diese Größe nennt Home Assistant als Standard für die virtuelle Festplatte.
  • Optional einen USB-Funkstick für Zigbee oder Thread.

Welche Hardware für Home Assistant sinnvoll ist, vergleicht der Ratgeber Home Assistant Hardware.

Die Bezeichnungen in dieser Anleitung entsprechen der englischen Proxmox-Oberfläche, die nach der Installation voreingestellt ist.

Schritt 1: VM anlegen

Klicke oben rechts auf „Create VM“ und gehe die Reiter durch:

  1. Im Reiter „General“ vergibst du einen Namen, z. B. homeassistant. Die VM-ID merkst du dir, im Beispiel 100.
  2. Im Reiter „OS“ wählst du „Do not use any media“. Ein Installationsmedium brauchst du nicht.
  3. Im Reiter „System“ stellst du „Machine“ auf q35. Bei „BIOS“ OVMF (UEFI) einstellen, als „EFI Storage“ deinen VM-Speicher angeben, z. B. local-lvm. Den Haken bei „Pre-Enroll keys“ entfernen. Home Assistant braucht laut Dokumentation UEFI ohne Secure Boot, und die vorab eingetragenen Schlüssel würden Secure Boot einschalten.
  4. Im Reiter „Disks“ löschst du die vorgeschlagene Festplatte mit dem Papierkorb-Symbol. Die Festplatte kommt später aus dem Abbild.
  5. Im Reiter „CPU“ trägst du 2 Kerne ein. Als „Type“ kannst du host wählen, dann sieht die VM die Funktionen des echten Prozessors.
  6. Im Reiter „Memory“ gibst du 4096 MB an. Weniger als 2048 MB solltest du laut Home Assistant nicht vergeben.
  7. Im Reiter „Network“ bleiben Bridge vmbr0 und Model „VirtIO“.

Mit „Finish“ legt Proxmox die VM an. Starte sie noch nicht.

Schritt 2: Abbild herunterladen und entpacken

Öffne auf der Home-Assistant-Seite „Alternative installation“ die Liste der Abbilder und kopiere den Link für „KVM/Proxmox“. Im November 2026 heißt die Datei haos_ova-18.4.qcow2.xz. Nimm immer den aktuellen Link von der Seite, die Versionsnummer ändert sich mit jedem Update.

In Proxmox wählst du links deinen Server (Node) und öffnest „Shell“. Dort lädst du die Datei herunter und entpackst sie:

wget https://github.com/home-assistant/operating-system/releases/download/18.4/haos_ova-18.4.qcow2.xz
unxz haos_ova-18.4.qcow2.xz

Danach liegt die Datei haos_ova-18.4.qcow2 im aktuellen Verzeichnis.

Schritt 3: Abbild in die VM importieren

Ebenfalls in der Shell importierst du das Abbild als Festplatte der VM:

qm disk import 100 haos_ova-18.4.qcow2 local-lvm

100 ist die VM-ID, local-lvm der Speicher für VM-Festplatten. Hast du Proxmox mit ZFS installiert, heißt dieser Speicher meist local-zfs. Ältere Anleitungen nutzen qm importdisk, das ist derselbe Befehl unter dem früheren Namen. Proxmox kopiert das Abbild und wandelt es in das passende Format um. Die heruntergeladene Datei kannst du danach mit rm haos_ova-18.4.qcow2 löschen.

Schritt 4: Festplatte einhängen und Bootreihenfolge setzen

  1. Wähle die VM aus und öffne „Hardware“. Dort steht jetzt „Unused Disk 0“.
  2. Doppelklick auf den Eintrag, als Bus „SCSI“ lassen und mit „Add“ bestätigen.
  3. Optional die Größe erhöhen: Festplatte markieren, „Disk Action“ und „Resize“. Home Assistant nennt das Vergrößern der Standardplatte ausdrücklich als möglich.
  4. Unter „Options“ den Eintrag „Boot Order“ öffnen, scsi0 aktivieren und nach oben ziehen.
  5. Ebenfalls unter „Options“ „Start at boot“ auf „Yes“ stellen, damit Home Assistant nach einem Neustart des Servers mitstartet.

Schritt 5: VM starten und Home Assistant einrichten

Starte die VM und öffne die „Console“. Nach dem ersten Start zeigt Home Assistant OS ein Banner mit der IP-Adresse. Die Einrichtung läuft im Browser:

http://homeassistant.local:8123

Funktioniert der Name in deinem Netz nicht, nimm die IP-Adresse aus der Konsole, z. B. http://192.168.1.60:8123. Der erste Start dauert einige Minuten, weil Home Assistant Komponenten nachlädt. Danach legst du dein Konto an und kannst ein vorhandenes Backup einspielen.

Damit Home Assistant immer unter derselben Adresse erreichbar ist, richte im Router eine feste Zuweisung (DHCP-Reservierung) für die VM ein.

Schritt 6: Zigbee- oder Thread-Stick durchreichen

Ein USB-Funkstick steckt am Proxmox-Rechner und muss an die VM weitergegeben werden:

  1. VM auswählen, „Hardware“, dann „Add“ und „USB Device“.
  2. „Use USB Vendor/Device ID“ wählen und den Stick aus der Liste nehmen.
  3. Die VM neu starten.

Die Bindung über die Hersteller-ID bleibt erhalten, wenn du den Stick in einen anderen Anschluss steckst. Home Assistant erkennt den Stick danach unter „Einstellungen“ und „Geräte & Dienste“.

Home Assistant Connect ZBT-2 (Zigbee oder Thread, von Nabu Casa) bei Amazon ansehen

Die Abkürzung per Skript

In der Home-Assistant-Community gibt es ein Skript, das die VM mit einem einzigen Befehl in der Proxmox-Shell anlegt, das Abbild lädt und importiert. Es stammt von Freiwilligen und läuft mit Root-Rechten auf deinem Server. Lies es vor der Ausführung oder nutze den manuellen Weg oben, dann weißt du auch, was in der VM eingestellt ist.

Sicherung der VM

Proxmox kann die ganze VM sichern: unter „Datacenter“ und „Backup“ legst du einen Zeitplan an. Home Assistant hat außerdem eigene Backups unter „Einstellungen“ und „System“. Am besten nutzt du beide: das Proxmox-Backup für einen schnellen Komplett-Rückweg, das Home-Assistant-Backup für den Umzug auf andere Hardware.

Häufige Fragen

VM oder LXC-Container für Home Assistant?

Eine VM. Home Assistant OS mit Add-ons und dem Supervisor ist für den Betrieb als eigenes System gedacht, und das offizielle Abbild ist ein VM-Abbild. In einem Container läuft nur Home Assistant Core ohne Add-ons.

Die VM startet nicht und bleibt im UEFI-Menü hängen. Was tun?

Meist ist Secure Boot aktiv oder die Bootreihenfolge stimmt nicht. Prüfe unter „Options“, ob scsi0 an erster Stelle steht. War bei „Pre-Enroll keys“ der Haken gesetzt, entferne die EFI-Disk unter „Hardware“ und lege sie ohne diese Option neu an.

Wie viel RAM braucht die Home-Assistant-VM?

Laut Home Assistant mindestens 2 GB. Mit Add-ons wie Zigbee2MQTT, ESPHome oder einer Datenbank sind 4 GB sinnvoll. Du kannst den Wert später ändern, die VM muss dafür neu starten.

Kann ich von einem Raspberry Pi auf Proxmox umziehen?

Ja. Erstelle auf dem Pi ein vollständiges Backup unter „Einstellungen“ und „System“, kopiere die Datei auf deinen Rechner und spiele sie beim ersten Start der neuen VM ein.