Home Assistant OS VM, diese HAOS (Home Assistant Operating System) VM läuft

Wer den Einstieg in die Welt der professionellen Hausautomatisierung wagt, stößt schnell auf Home Assistant OS (HAOS). Home Assistant OS VM beendet die Suche nach der perfekten Hosting-Umgebung die oft einer Odyssee gleicht. Während viele mit Windows-basierten Lösungen oder Docker-Containern beginnen, zeigt die Praxis: Wenn es wirklich stabil laufen soll – inklusive HomeKit und Google Home – führt kein Weg an KVM unter Linux vorbei.

Dieser Leitfaden ist für alle, die eine Lösung suchen, die nicht nur „irgendwie“, sondern dauerhaft und performant funktioniert. Kompatibel mit Linux Mint, Ubuntu, Debian und allen anderen Debian-basierten Distributionen.

Warum andere Plattformen oft scheitern

Windows, VMware, VirtualBox und Hyper-V

Viele starten mit VirtualBox oder VMware unter Windows. Für ein 24/7 Smart Home ist das jedoch eine Sackgasse:

• Netzwerk-Isolation: Windows-Hypervisoren haben massive Probleme mit mDNS (Multicast DNS). HomeKit und Google Home verlassen sich auf mDNS, um Geräte zu finden. In einer virtualisierten Windows-Umgebung „stirbt“ dieser Traffic oft an der virtuellen Brücke.
• Ressourcen-Overhead: Windows verbraucht als Host zu viel RAM und CPU. Zudem führen Hintergrund-Updates oft zu ungewollten Neustarts der gesamten Smart-Home-Zentrale.
• Hardware-Passthrough: Das Durchreichen von USB-Sticks (Zigbee, WLAN) ist instabil. Nach einem Reboot verliert die VM oft die Verbindung zur Hardware.

Die Docker-Einschränkung

Docker ist effizient, aber für HAOS ungeeignet, wenn man den vollen Funktionsumfang (Supervisor, Add-ons, Backups) will. Zudem ist die Netzwerkkonfiguration für HomeKit in Docker-Umgebungen ein Albtraum, da der Container direkten Zugriff auf den Host-Netzwerkstack benötigt, was oft zu Port-Konflikten führt.

---

Die Lösung: KVM unter Linux

KVM (Kernel-based Virtual Machine) ist direkt im Linux-Kernel integriert. Es bietet die Performance einer „Bare Metal“-Installation. Es ist der Goldstandard für mDNS-Stabilität und damit die Grundvoraussetzung für eine funktionierende HomeKit- und Google Home-Integration.

---

Konnektivität: LAN vs. WLAN

Die Vorzüge der LAN-Verbindung

Ein Smart-Home-Server gehört an das Ethernet-Kabel. LAN bietet minimale Latenz und maximale Stabilität. Da die meisten WLAN-Chipsätze am Host kein „Bridging“ unterstützen (sie lassen nur eine MAC-Adresse zu), muss die VM über ein NAT-Netzwerk angebunden werden. Hier greift unser Netzwerk-Fix (siehe unten).

Die WLAN-Lösung (Mit dediziertem USB-Stick)

Ist kein Kabel möglich, scheitern Standard-VMs meist kläglich. Die Lösung: Ein externer USB-WLAN-Stick, der exklusiv an die VM durchgereicht wird.

• Vorteil: Die VM bekommt eine eigene, echte IP vom Router und umgeht das mDNS-Problem hardwareseitig.
• Wichtig: Auch bei WLAN-Nutzung ist der folgende Netzwerk-Fix als „Management-Backup“ ratsam, um den Zugriff vom Host auf die VM jederzeit zu garantieren.

---

Schritt-für-Schritt Installations-Leitfaden

1. Download & Vorbereitung des Images

Lade das aktuelle KVM-Image (.qcow2) herunter:

• Link: Home Assistant OS KVM Image

Entpacke die Datei. Der beste Ort für die Speicherung unter Linux ist das Standard-Verzeichnis für VM-Images, um Rechteprobleme zu vermeiden:

# Verzeichnis Anlegen
sudo mkdir -p /var/lib/libvirt/images

# Kopieren an den Bestimmungsort (Beispielhafter Pfad)
sudo cp /pfad/zu/deinem/download/haos_ova-xx.x.qcow2 /var/lib/libvirt/images/home_assistant.qcow2

2. KVM & Management-Tools installieren

sudo apt update
sudo apt install qemu-kvm libvirt-daemon-system libvirt-clients bridge-utils virt-manager
sudo adduser $USER libvirt
sudo adduser $USER kvm

(Danach einmal ab- und wieder anmelden!)

3. Der Netzwerk-Fix (Essentiell für LAN & HomeKit)

Damit die Kommunikation zwischen Host und VM (und damit HomeKit/Google Home) über die virtuelle Brücke virbr0 funktioniert, müssen wir die IP-Tables anpassen.

Script erstellen:

sudo nano /usr/local/bin/ha-network-fix.sh

Inhalt einfügen:

#!/bin/bash
sysctl -w net.ipv4.ip_forward=1
iptables -A FORWARD -i virbr0 -j ACCEPT
iptables -A FORWARD -o virbr0 -j ACCEPT
iptables -t nat -A POSTROUTING -s 192.168.122.0/24 ! -d 192.168.122.0/24 -j MASQUERADE

Rechte vergeben: sudo chmod +x /usr/local/bin/ha-network-fix.sh

Systemd-Service für den Autostart:

sudo nano /etc/systemd/system/ha-network.service

Inhalt:

[Unit]
Description=HA Network Fix
After=network.target

[Service]
Type=oneshot
ExecStart=/usr/local/bin/ha-network-fix.sh

[Install]
WantedBy=multi-user.target

Aktivieren: sudo systemctl enable --now ha-network.service

4. VM-Erstellung im Virt-Manager

Öffne den Virtual Machine Manager.

„Neue virtuelle Maschine“ → „Vorhandenes Festplatten-Abbild importieren“.

Wähle /var/lib/libvirt/images/home_assistant.qcow2 aus.

Wähle unten „Wählen Sie das Betriebssystem aus, das Sie installieren möchten.“
Hier verwenden wir Debian 13. Um eine Auswahl angezeigt zu bekommen, gib einfach „deb“ im Suchfeld ein. Wähle anschließend „Debian 13“ aus und klicke auf → „Weiter“.

Für die Installation erhöhen wir den Speicher von 2048 MB auf 6000 MB und setzen die CPUs auf 6 Kerne. Beachte dabei, dass du an die maximalen Werte deiner physisch vorhandenen Hardware gebunden bist. Nach der Installation kannst du die Werte wieder reduzieren. Hier geht es lediglich um eine schnellere Installation. Klicke anschließend auf → „Weiter“.

Name der virtuellen Maschine / Voreinstellungen

• Name der VM: Vergib einen Namen.
• Konfiguration vor der Installation bearbeiten: Aktivieren – wichtig!
• Netzwerk: Wähle „Virtual Network ‚default‘: NAT“. Falls du eine Meldung erhältst, dass es deaktiviert ist, klicke auf „Aktivieren“.

Klicke anschließend auf → „Weiter“.

Konfiguration vor der Installation

• Chipsatz: q35 – sollte bereits vorausgewählt sein, andernfalls diesen auswählen.
• Firmware: Wähle unbedingt UEFI x86_64:/usr/share/OVMF/OVMF_CODE_4m.fd aus. Diese Option sollte funktionieren. Falls du abweichende Hardware verwendest, musst du gegebenenfalls die anderen verfügbaren Optionen ausprobieren, um eine kompatible Variante zu finden.

Optional für WLAN

„Hardware hinzufügen“ → „USB-Hostgerät“ → Wähle deinen USB-WLAN-Stick aus.

Jetzt musst du oben links auf „Installation beginnen“ klicken!

---

Datenübernahme

Wenn du Daten von einer bereits existierenden Instanz übernehmen möchtest, kopiere jetzt bitte eine Sicherung deiner alten Installation von Mount-Point/Volumen/ha/config/backups auf den Desktop des Computers, auf dem die neue virtuelle Maschine läuft.

Tipps!!!

Starte unmittelbar vor dem Kopieren der Sicherung manuell ein Backup, wenn du Daten übernehmen möchtest, damit ein möglichst aktueller Stand der Daten migriert wird.

Deaktiviere die alte Installation oder fahre sie herunter. Andernfalls kommt es zu Konflikten bei den Identitäten, wenn die neue HAOS-Installation versucht, auf deine Geräte/Sensoren zuzugreifen, während die alte Installation noch darauf zugreift.

Starte die Home Assistant Oberfläche, wie im VM-Fenster angezeigt, zum Beispiel in einem Browser:

http://192.168.122.114:8123

Wähle auf deinem Startbildschirm „Mein Smarthome erstellen“, „Home Assistant Cloud“ oder „Backup hochladen“ aus.

Im Video verwenden wir dafür „Backup hochladen“.

---

Betrieb

Wenn du ein neues Smarthome erstellt hast, kannst du jetzt mit der Einrichtung fortfahren, deine Integrationen einrichten und deine Geräte hinzufügen.

Solltest du „Backup wiederherstellen“ gewählt haben, musst du jetzt zunächst deine Integrationen neu starten oder die Konfiguration über die Dienstanmeldung wiederherstellen.

Im Video siehst du das anhand der Tuya Smart App-Integration.

Zweite USB-WLAN-Karte einrichten

Gehe zu „Einstellungen“ → „System“ → „Netzwerk“ und konfiguriere den USB-WLAN-Stick wie im Video gezeigt.

Unter Netzwerkschnittstellen findest du zwei Netzwerkkarten. Wir bearbeiten die Netzwerkkarte, die auf dem HA-VM-Bildschirm als „Ohne Adresse“ angezeigt wird.

Folge hier ebenfalls dem Video für die Details.

File Editor installieren und trustet Proxys anpassen. Wird ebenfalls im Video in der Grafischen Oberfläche gezeigt.

---

Automatisierung

Automatischer Systemstart

Damit Home Assistant nach einem Host-Neustart sofort hochfährt:

sudo virsh autostart [Name_deiner_VM]

Das Shutdown-Problem

Der automatische Shutdown über den Host funktioniert bei HAOS meist nicht.

• Warum? HAOS reagiert oft nicht schnell genug auf die ACPI-Signale von KVM. Der Host „killt“ die VM dann nach einem Timeout hart.
• Die Gefahr: Dies kann die Home Assistant Datenbank beschädigen.
• Wichtig: Bevor du den Linux-Host ausschaltest, fahre Home Assistant immer manuell über die Oberfläche herunter (Einstellungen -> System -> Hardware -> Herunterfahren).

---

---

#SmartHome #HomeAssistant #Linux #KVM #HomeKit #GoogleHome #SelfHosting #LinuxTips #HAOS