Home Assistant OS VM auf Proxmox VE mit Helper-Scripts einrichten

24. Oktober 2025 Electroteddy

Die Proxmox VE Helper-Scripts, ursprünglich von tteck ins Leben gerufen und nun von der Community weitergeführt, sind der schnellste Weg, um Home Assistant OS als virtuelle Maschine (VM) auf deinem Proxmox VE Server zu installieren. Du benötigst lediglich einen einzigen Befehl in der Proxmox Shell.

Schau dich auch gerne auf der Seite der Proxmox VE Helper-Scripts um, hier gibt es jede Menge nützlicher Programme die mit nur einem Befehl installiert werden können.

1. Voraussetzungen prüfen

Bevor du startest, stelle sicher, dass folgende Punkte erfüllt sind:

Proxmox VE: Du solltest eine installierte und laufende Proxmox VE-Instanz (Version 8.x oder neuer empfohlen) haben.
Speicherplatz: Dein Proxmox-Server benötigt mindestens 32 GB freien Speicher auf dem Speicherziel (Festplatte/SSD), da das Skript die virtuelle Festplatte initial mit dieser Größe anlegt, welche während des Installationsprozesses nicht geändert werden kann.

2. Das Helper-Script ausführen

Der gesamte Installationsprozess wird über ein einziges Kommando in der Proxmox Shell gestartet.

Öffne die Proxmox Shell: Melde dich in der Proxmox Web-Oberfläche an. Wähle deinen Proxmox-Node (den Servernamen links) und klicke dann auf den Button „>_ Shell“ in der oberen Navigationsleiste.
Kopiere den Befehl: Der offizielle Community-Befehl für das Home Assistant OS VM-Skript lautet (Stand: 2025):
bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/vm/haos-vm.sh)"
Füge den Befehl ein und starte das Skript: Füge den kopierten Befehl in die Proxmox Shell ein (oft funktioniert Strg + V nicht, versuche es mit der rechten Maustaste und „Einfügen“ oder Strg + Shift + V). Bestätige die Eingabe mit Enter.

3. Skript-Abfragen beantworten

Das Skript beginnt nun mit dem Download und der Konfiguration. Es wird dich in der Regel nach zwei Dingen fragen:

„Install Home Assistant OS VM?“ (oder ähnlich): Bestätige dies mit Enter.
„Use Default Settings?“: Es wird dringend empfohlen, die Standardeinstellungen zu verwenden, da diese für die meisten Anwendungsfälle optimiert sind. Bestätige auch hier mit Enter. Optional kannst du hier Advanced wählen, um erweiterte Einstellungen (CPU-Kerne, RAM-Größe, VM ID etc.) manuell anzupassen.

Das Skript lädt nun automatisch das neueste Home Assistant OS Image herunter, erstellt die VM und konfiguriert sie mit den notwendigen Einstellungen. Warte, bis die Meldung „Completed Successfully“ erscheint.

4. VM starten und Home Assistant aufrufen

Schließe die Shell: Sobald das Skript fertig ist, kannst du das Shell-Fenster schließen.
Finde die VM: Die neu erstellte Home Assistant VM (sie sollte home-assistant, haos oder eine ähnliche Bezeichnung tragen) erscheint in der linken Navigationsleiste unter deinem Proxmox-Node. In den meisten Fällen startet das Skript die VM automatisch.
Finde die IP-Adresse: Klicke auf die Home Assistant VM und wähle den Reiter „Summary“ (Übersicht). Hier wird nach kurzer Zeit die IP-Adresse der VM angezeigt. Alternativ kannst du auch den Reiter „Console“ (Konsole) wählen, wo die IP-Adresse ebenfalls angezeigt wird, sobald Home Assistant OS vollständig hochgefahren ist.
Greife auf Home Assistant zu: Öffne einen Webbrowser und gib die ermittelte IP-Adresse gefolgt vom Port :8123 ein, z.B. http://192.168.1.100:8123.
Onboarding abschließen: Home Assistant lädt die Ersteinrichtung. Folge den Anweisungen, um dein Benutzerkonto zu erstellen, deinen Standort festzulegen und das Onboarding abzuschließen.

Fertig! Deine Home Assistant OS VM läuft nun auf Proxmox. Du kannst jederzeit über die Proxmox Web-Oberfläche die Hardware-Einstellungen (RAM, CPU-Kerne) der VM anpassen.