· Aktualisiert: · 12 Min. Lesezeit

Home Assistant auf Proxmox installieren: VM in 30 Minuten (2026)

Home Assistant OS als VM auf Proxmox installieren, mit Image, USB-Passthrough und Backup. Schritt für Schritt für 2026.

Affiliate-Hinweis: Einige Links in diesem Artikel sind Affiliate-Links. Beim Kauf über diese Links erhalten wir eine kleine Provision — für dich ändert sich am Preis nichts.

Du willst dein Smart Home mit Home Assistant steuern und hast einen Proxmox-Server? Dann bist du hier richtig. In dieser Anleitung zeige ich dir Schritt für Schritt, wie du Home Assistant OS als virtuelle Maschine auf Proxmox VE installierst — inklusive USB-Passthrough, Backup und den häufigsten Fehlerquellen.

CPU & RAM: Wie viel braucht Home Assistant? (Dimensionierung & Hardware-Tipps)

Bevor du dich in die eigentliche Installation stürzt, solltest du dir Gedanken über die Ressourcendimensionierung machen. Home Assistant kommt zwar grundsätzlich mit wenig RAM und CPU klar, aber der Teufel steckt wie immer im Detail. Ein schlanker Setup mit ein paar Basis-Integrationen läuft schon mit 2 GB RAM und 1-2 vCPUs. Das reicht für ca. 5-8 einfache Add-ons und keine Machine-Learning-Experimente.

Sobald du aber Integrationen wie Frigate (Kameraüberwachung, Objekt-Erkennung via Tensorflow), Grafana/InfluxDB für Langzeitdaten, zig Zigbee-Geräte und anspruchsvolle Automationen einsetzt, wird’s sehr schnell eng. Richtwerte:

  • 2 GB RAM, 1-2 vCPU: Leichtes Setup mit max. 5 Add-ons, keine Videos/ML.
  • 4-6 GB RAM, 2-4 vCPU: Fortgeschritten, 10–15 Add-ons, ein paar Automationen, leichte Visualisierung.
  • 8 GB+ RAM, 4+ vCPU: Heavy User, Frigate, Kamera-Add-ons, Machine Learning, viele Integrationen & Sensoren.

Praxis-Faustregel: Lieber ein paar GB mehr als zu wenig investieren. RAM ist für Home Assistant wichtiger als CPU, wenn du zwischen beidem wählen musst. Die meisten Probleme entstehen durch zu wenig RAM – dann freezt dir die Kiste und alles steht. CPU wird erst beim Frigate/ML-Kram kritisch oder wenn viele Automationen zeitgleich ballern.

Hardware-Empfehlung für Proxmox-Hosts (Budget bis „geht ab“)

Für Einsteiger und Bastler sind kompakte Intel N100 Mini-PCs (z.B. der BEASTCOM M1 Mini PC (Intel N100, 16GB RAM)) überraschend performant und günstig (meist lüfterlos, ~6W Idle, voll VM-tauglich für Home Assistant, Pi-hole, kleine NAS).

Wem das zu wenig ist oder wer noch Nextcloud, Frigate und einen halben Zoo an Docker-Containern fahren will: Lieber auf was wie einen ASUS NUC 13 Pro Slim Kit (Core i5-1340P) oder einen Ryzen-basierten Mini-PC schielen. Wichtig: SSD statt HDD, mindestens 8 GB RAM, ideal 16 GB falls Budget da ist. Günstige N100-Boxen liefern oft schon genug Dampf für alles außer Frigate plus Multi-Stream-Überwachung.


Community-Script: Proxmox Helper als Abkürzung?

Du willst dir den manuellen Scheiß sparen? Es gibt ein recht bekanntes Community-Script, das die Home-Assistant-Installation auf Proxmox mit wenigen Klicks automatisiert: Das tteck Proxmox Helper Script übernimmt fast alles (VM anlegen, Image rein, perfekte Settings). Für Einsteiger komfortabel – aber du weißt dann halt einen Dreck, was im Hintergrund passiert. Fehler beheben? Ohne Plan eher zäh.

Wichtiger Hinweis: tteck, der ursprüngliche Maintainer, ist verstorben. Das Projekt wird von der Community weitergeführt, aber prüf kurz im Proxmox Forum oder auf GitHub ob die aktuelle Domain/Version noch stimmt, bevor du das blind ausführst.

Deshalb wird hier der manuelle Weg erklärt – so lernst du, was Proxmox wie und warum macht.


Was du brauchst

  • Einen laufenden Proxmox VE Server (Version 8.x oder neuer)
  • Mindestens 2 GB RAM und 32 GB Speicher für die VM (empfohlen: 4 GB RAM, 64 GB Disk)
  • Internetzugang auf dem Server
  • Ca. 20-30 Minuten Zeit

Warum Home Assistant auf Proxmox?

Home Assistant lässt sich auf vielen Wegen installieren — Raspberry Pi, Docker, direkt auf einem Mini-PC. Aber Proxmox hat entscheidende Vorteile:

Vorteile der Proxmox-Variante:

  • Snapshots und Backups auf Knopfdruck — vor einem Update kurz einen Snapshot machen, bei Problemen in Sekunden zurückrollen
  • Hardware-Ressourcen flexibel zuweisen — mehr RAM oder CPU-Kerne? Ein Klick in der Weboberfläche
  • Andere VMs/Container parallel betreiben — Pi-hole, Nextcloud, Frigate, Mosquitto, Grafana
  • USB-Passthrough für Zigbee/Z-Wave-Sticks — funktioniert zuverlässig
  • Professionelle Virtualisierung — KVM-basiert, stabil, performant
  • Kein SD-Karten-Verschleiß wie beim Raspberry Pi

Alternativen und wann sie sinnvoller sind:

  • Raspberry Pi: Wenn du noch keinen Server hast und erstmal nur testen willst (günstigster Einstieg, Anleitung hier)
  • Docker/Container: Wenn du Home Assistant Container ohne App-Support nutzen willst (fortgeschritten)
  • Dedizierter Mini-PC: Wenn du einen einzelnen Rechner nur für HA nutzen willst (einfachste Installation)

Schritt 1: Home Assistant Image herunterladen

Öffne die Proxmox-Shell (entweder über die Weboberfläche unter Node → Shell oder per SSH) und lade das aktuelle Home Assistant OS Image herunter:

cd /var/lib/vz/template/
# WICHTIG: Aktuelle Version immer auf der Release-Seite prüfen!
# Beispiel-Version unten ist ggf. veraltet — Versionsnummer im Dateinamen anpassen!
wget https://github.com/home-assistant/operating-system/releases/download/14.2/haos_ova-14.2.qcow2.xz
unxz haos_ova-14.2.qcow2.xz

Wichtig: Die Versionsnummer im Befehl (hier 14.2) kann veraltet sein. Prüfe immer auf der offiziellen Release-Seite die aktuellste Version und passe Dateiname und URL entsprechend an.

Hinweis: Das Entpacken mit unxz kann ein paar Sekunden dauern — das ist normal. Die fertige .qcow2-Datei ist ca. 2 GB groß.

Schritt 2: VM erstellen

Erstelle eine neue VM über die Proxmox-Weboberfläche:

  1. Klicke auf „Create VM” (oben rechts)
  2. General:
    • VM-ID: z.B. 100
    • Name: homeassistant
  3. OS:
    • Wähle „Do not use any media” — wir importieren das Image gleich separat
  4. System:
    • BIOS auf OVMF (UEFI) stellen
    • EFI Storage auswählen (z.B. local-lvm)
    • Machine auf q35 setzen
    • ⚠️ Wichtig: OVMF (UEFI) und q35 werden für Home Assistant OS dringend empfohlen und garantieren stabile Updates und volle Funktionalität. In manchen Fällen startet HA auch mit SeaBIOS/i440fx, aber das ist kein zuverlässiger Setup — nimm immer UEFI/q35!
  5. Disks:
    • Die Standard-Disk kannst du löschen — wir importieren gleich das Image
  6. CPU:
    • Mindestens 2 Kerne (Empfehlung: 2-4)
    • Type: host für beste Performance
  7. Memory:
    • Mindestens 2048 MB (4096 MB empfohlen, besonders wenn du viele Apps nutzen willst)
  8. Network:
    • Bridge auswählen (meistens vmbr0)
    • Model: VirtIO (paravirtualized) — beste Performance

Die VM noch nicht starten!

Schritt 3: Disk importieren

Jetzt importierst du das heruntergeladene Image als Disk in deine VM:

qm importdisk 100 /var/lib/vz/template/haos_ova-14.2.qcow2 local-lvm

Ersetze 100 durch deine VM-ID und local-lvm durch deinen Storage-Namen.

Danach in der Proxmox-Weboberfläche:

  1. Gehe zu deiner VM → Hardware
  2. Die importierte Disk erscheint als „Unused Disk 0”
  3. Doppelklick darauf → Add
  4. Bus auf SCSI setzen (nicht IDE oder SATA)
  5. Cache auf Write back für bessere Performance

Boot-Order anpassen:

  1. VM → OptionsBoot Order
  2. Die neue SCSI-Disk als erstes Boot-Device setzen
  3. Die EFI-Disk muss ebenfalls aktiv sein
  4. Alles andere deaktivieren

Schritt 4: VM starten und einrichten

Starte die VM. Home Assistant OS bootet und richtet sich automatisch ein. Das dauert beim ersten Start 5-10 Minuten — in der Proxmox-Konsole siehst du den Fortschritt.

Danach erreichst du Home Assistant im Browser unter:

http://homeassistant.local:8123

Falls das nicht funktioniert (mDNS nicht verfügbar oder blockiert), schau in der Proxmox-Konsole nach der IP-Adresse. Sie wird nach dem Boot angezeigt:

http://[IP-ADRESSE]:8123

Keine Panik: Es kann nach dem ersten Boot noch 2-3 Minuten dauern, bis die Weboberfläche erreichbar ist. Home Assistant lädt im Hintergrund Updates und richtet sich ein.

Schritt 5: Onboarding

Beim ersten Zugriff führt dich Home Assistant durch das Onboarding:

  1. Benutzerkonto anlegen — Name, Benutzername, Passwort (gut merken — das ist der Admin-Account!)
  2. Standort festlegen — für Wetter, Sonnenauf-/-untergang und zeitbasierte Automationen
  3. Netzwerk-Erkennung — Home Assistant findet automatisch kompatible Geräte (Hue-Bridge, Sonos, Chromecast, etc.)
  4. Telemetrie — optional, kannst du ablehnen
  5. Fertig — du bist drin!

USB-Passthrough für Zigbee/Z-Wave

Wenn du einen Zigbee-Stick (z. B. Sonoff ZBDongle-P, Sonoff ZBDongle-E) oder Z-Wave-Stick nutzen willst, musst du ihn an die VM durchreichen:

Schritt-für-Schritt:

  1. Stick identifizieren — auf dem Proxmox-Host:

    lsusb

    Such dir deinen Stick raus (z.B. Bus 001 Device 003: ID 10c4:ea60 Silicon Labs CP210x)

  2. VM stoppen (falls sie läuft)

  3. USB-Device hinzufügen:

    • VM → HardwareAddUSB Device
    • Wähle „Use USB Vendor/Device ID”
    • Deinen Stick aus der Liste auswählen
  4. VM starten

Tipp: Nutze Vendor/Device ID statt Port-Nummer. So bleibt der Passthrough auch nach einem Neustart stabil, selbst wenn sich die USB-Port-Zuordnung ändert. Eine USB-Verlängerung kann bei Interferenzen mit anderen USB-Geräten helfen.

Alternativ: Netzwerk-Coordinator — Wenn du Probleme mit USB-Passthrough hast (besonders in verschachtelten Virtualisierungssetups), ist ein Netzwerk-Zigbee-Coordinator wie der SLZB-06 die stressfreiere Lösung.

Automatische Backups einrichten

Einer der größten Vorteile von Proxmox — richte sofort automatische Backups ein:

In Proxmox:

  1. DatacenterBackupAdd
  2. Storage: z.B. local oder ein NFS-Share
  3. Schedule: Täglich, z.B. um 03:00 Uhr
  4. Mode: Snapshot (VM muss nicht heruntergefahren werden)
  5. Retention: 7 Tage (oder mehr, wenn genug Speicher vorhanden)

Snapshots vor Updates:

Bevor du ein Home-Assistant-Update einspielst:

qm snapshot 100 pre-update --description "Vor HA Update auf Version X.Y"

Falls das Update Probleme macht:

qm rollback 100 pre-update

In 30 Sekunden bist du zurück auf dem vorherigen Stand.

Häufige Fehler und Lösungen

„Preparing Home Assistant” hängt ewig

Das Onboarding zeigt „Preparing Home Assistant” und bewegt sich nicht? Das ist normal beim ersten Start. Warte bis zu 20 Minuten. Falls es wirklich hängt:

  • Prüfe die Proxmox-Konsole — gibt es Fehlermeldungen?
  • Hat die VM Internetzugang? (Ping-Test über die HA-Konsole mit loginping google.com)
  • Genug RAM zugewiesen? Unter 2 GB wird’s eng

VM bootet nicht (UEFI-Fehler)

  • Hast du OVMF (UEFI) als BIOS und q35 als Machine gewählt?
  • Ist die Boot-Reihenfolge korrekt (SCSI-Disk zuerst)?
  • Wurde die Disk als SCSI und nicht als IDE hinzugefügt?

USB-Stick wird nicht erkannt

  • Ist der USB-Passthrough korrekt eingerichtet? (Vendor/Device ID statt Port)
  • VM nach dem Hinzufügen des USB-Devices neugestartet?
  • Funktioniert der Stick auf dem Host (dmesg | tail -20 nach dem Einstecken)?

Weboberfläche nicht erreichbar

  • IP-Adresse prüfen in der Proxmox-Konsole
  • Firewall? Proxmox-Firewall kann Port 8123 blockieren
  • Richtiges Netzwerk? VM und Client müssen im gleichen Subnetz sein (oder Routing konfiguriert)

Performance-Optimierungen

Ein paar Tweaks für optimale Performance:

  • CPU Type auf host: Nutzt alle CPU-Features deines Hosts
  • VirtIO-Treiber: Für Netzwerk und Disk — sind standardmäßig die schnellste Option
  • Ballooning deaktivieren: Unter Memory → Advanced → „Ballooning Device” abschalten — HA-OS kommt damit nicht gut klar
  • SSD-Emulation: Falls du eine SSD im Host hast, unter Disk → Advanced → „SSD emulation” aktivieren

Netzwerk-Konfiguration: Statische IP, VLANs & mehr

Netzwerk ist keine Nebensache, sondern entscheidend für ein sauberes Smart Home-Setup. Home Assistant zieht sich standardmäßig per DHCP seine IP. Wenn du willst, dass Integrationen wie Sprachassistenten, Alexa, Zigbee-Bridge oder externe Sensoren auch nach einem Neustart noch alles schnallen, dann lass die HA-VM immer unter der gleichen IP laufen.

Statische IP zuweisen: Zwei Wege, ein Ziel

  1. Empfohlen: Lege im Router für die MAC-Adresse der Home Assistant VM eine DHCP-Reservierung an. Die VM bekommt dann immer die gleiche IP vom Router. Vorteil: Setup bleibt sauber, änderst du Nickligkeiten zentral im Router, kein Gemurkse in der VM.

  2. Direkt in der VM: Öffne die Home Assistant Konsole (direkt per Proxmox oder SSH, nicht das Webinterface) und setze die IP per CLI:

    ha network info
    ha network update eth0 --ipv4-method static --ipv4-address 192.168.178.50/24 --ipv4-gateway 192.168.178.1
    ha network reload

    Werte wie IP/Gateway natürlich auf dein Netz anpassen. Nach diesem Schritt sollte die GUI prompt unter der neuen IP erreichbar sein (prüfen!).

VLANs für Fortgeschrittene

Wenn deine Hütte langsam aussieht wie ein Kabinett für Zigbee, Shelly und sonstigen IoT-Dreck, denk über ein eigenes VLAN für Home Assistant bzw. IoT-Geräte nach. Das bringt a) mehr Übersicht, b) bessere Sicherheit (IoT bleibt von deinem „Banking“-Netz fern) und c) weniger Ärger, wenn mal ein Gerät China-Cloud nach Hause funkt. VLAN-Konfiguration geht am elegantesten direkt im Proxmox (Bridge-Interface + VLAN-Tag zuweisen), entsprechende VLAN-ID dann beim Anlegen der VM angeben oder später ergänzen. Die Home Assistant OS-Konsole versteht VLAN-Tags ( —ipv4-method … —vlan-id …), siehe offizielle HA-Doku.


Mehrere VMs/Dienste auf Proxmox: Was geht neben HA?

Warum nur Home Assistant fahren, wenn Proxmox locker noch andere Dienste packt? Typische Kombis in der Praxis:

  • Pi-hole als LXC-Container: Werbung und Tracker im Heimnetz direkt killen, ressourcenschonend mit 256–512 MB RAM, 1 vCPU.
  • Mosquitto (MQTT-Broker): Basis für zig Integrationen – läuft als LXC meistens mit 128 MB RAM, 1 vCPU flott.
  • Frigate für Kameras: Videoüberwachung mit KI (Objekterkennung), braucht mehr: 4–8 GB RAM, dedizierte vCPU und nach Möglichkeit GPU-Passthrough (z.B. Coral USB/PCIe oder Intel Quick Sync). Nichts für Billig-Boxen mit Atom-CPU.
  • Grafana & InfluxDB: Historische Sensordaten tracken, schöne Dashboards. Als LXC oder VM, mind. 1–2 GB RAM, 1 vCPU. Platte eher üppig dimensionieren (Datenbank wächst fix).

Ressourcen-Tipp: Gönn Home Assistant „Minimum RAM zuerst“, alle anderen Dienste bekommen den Rest. Lieber Pi-hole 256 MB abschnüren als HA drosseln — sonst bockt das Smart Home schneller als du „Mist“ sagen kannst.


Proxmox- und Home Assistant-Update: Sicher statt sorry

Nicht wild einfach klicken und hoffen – Updates immer mit Plan:

  1. Vor jedem Update einen Snapshot der VM machen:

    qm snapshot 100 before-ha-update --description "Stand vor HA-Update XY"

    Rollback klappt dann in Sekunden, falls das Update irgendwas grillt.

  2. Home Assistant OS/Apps updaten: Geht einfach über das HA-Webinterface – aber immer erst nach Snapshot.

  3. Proxmox selber updaten:

    apt update && apt dist-upgrade

    Danach immer alle VMs/Container einmal sauber rebooten und checken, ob alles hochkommt.

  4. Update-Zyklus: Home Assistant monatlich oder nach Major Release updaten, Proxmox am besten erst ein paar Tage nach Release, wenn im Forum keine riesen Bugwelle losbricht. Lieber ein Release abwarten, bevor’s den Hypervisor zerlegt.


Nächste Schritte

Dein Home Assistant läuft — was jetzt?

Fazit

Home Assistant auf Proxmox ist die flexibelste und zuverlässigste Lösung für ein ernsthaftes Smart Home. Du hast volle Kontrolle über Ressourcen, kannst jederzeit Snapshots erstellen, rollst bei Problemen in Sekunden zurück und betreibst nebenbei noch andere Dienste auf demselben Server.

Der Einrichtungsaufwand liegt bei 20-30 Minuten — und du hast ein Setup, das jahrelang stabil läuft. Kein SD-Karten-Ausfall, kein Frickel-Docker, kein „hoffentlich geht das Update gut”. Einfach solide Virtualisierung für dein smartes Zuhause.

Philipp Just

Gründer & Autor

Schreibt über Home Assistant, ESP32 und alles was das Smart Home smarter macht.