Installation auf Proxmox

Schritt-für-Schritt zur perfekten VM

Weiter unten findest Du die SSH Installation.

 

Die einfachste Installationsmethode in wenigen Minuten

Was ist das Helper Script?

Das Community Helper Script ist ein automatisiertes Installations-Tool, das die komplette Home Assistant VM auf Proxmox erstellt. Es übernimmt alle Schritte – vom Download des Images über die VM-Erstellung bis zur Konfiguration. Entwickelt von der Proxmox-Community, wird es ständig aktualisiert und ist die empfohlene Installationsmethode für Einsteiger.

Vorteile des Helper Scripts

Das Script spart dir viel Zeit und verhindert Fehler. Du musst keine Befehle manuell eingeben, keine Images herunterladen oder VM-Einstellungen konfigurieren. Das Script fragt dich nach deinen Präferenzen und erstellt automatisch eine optimierte VM. Es nutzt die neueste HAOS-Version und konfiguriert alle wichtigen Parameter wie CPU-Typ, Speicher und Netzwerk optimal.

Besonders praktisch: Das Script bietet auch Update-Funktionen und kann später zur Verwaltung der VM genutzt werden.

Voraussetzungen

Du benötigst einen laufenden Proxmox-Server mit Internetzugang und SSH-Zugriff. Stelle sicher, dass du als Root-Benutzer arbeiten kannst. Dein Proxmox sollte auf dem neuesten Stand sein – führe vorher ein Update durch, falls du das länger nicht gemacht hast.

Proxmox vorbereiten

Melde dich per SSH an deinem Proxmox-Server an. Nutze einen SSH-Client wie PuTTY auf Windows oder das Terminal auf Linux/Mac. Der Befehl lautet: ssh root@DEINE-PROXMOX-IP

Nach erfolgreicher Anmeldung bist du im Root-Verzeichnis deines Proxmox-Servers.

Optional kannst du auch die Proxmox Shell in der Web-UI nutzen. Öffne dazu die Proxmox Web-Oberfläche, wähle deinen Node in der linken Seitenleiste aus und klicke auf „Shell“. Dies öffnet eine Browser-basierte Konsole.

Helper Script herunterladen und starten

Das Helper Script wird direkt von GitHub geladen und ausgeführt. Kopiere folgenden Befehl und füge ihn in deine SSH-Sitzung ein:

bash -c "$(wget -qLO - https://github.com/tteck/Proxmox/raw/main/vm/haos-vm.sh)"

Drücke Enter. Das Script lädt automatisch herunter und startet.

Was passiert jetzt?

Das Script prüft zunächst deine Proxmox-Umgebung. Es überprüft, ob alle Voraussetzungen erfüllt sind und ob genügend Ressourcen verfügbar sind. Anschließend erscheint ein Begrüßungsbildschirm mit Informationen über die Installation.

Du wirst gefragt, ob du mit den Standard-Einstellungen fortfahren möchtest oder ob du erweiterte Optionen nutzen willst.

Standard-Installation (empfohlen für Einsteiger)

Wenn du die Standard-Einstellungen nutzen möchtest, wähle „Yes“ oder drücke einfach Enter. Das Script verwendet dann folgende Standardwerte:

• VM ID: Automatisch die nächste freie ID
• VM Name: haos
• CPU Kerne: 2
• RAM: 4096 MB (4 GB)
• Disk Größe: 32 GB
• Bridge: vmbr0
• MAC Adresse: Automatisch generiert
• VLAN: Kein VLAN
• MTU: Standard
• Start on Boot: Ja
• Storage: local-lvm (oder dein Default-Storage)

Das Script lädt jetzt das neueste HAOS-Image herunter, erstellt die VM, importiert die Disk und startet die VM automatisch. Dieser Prozess dauert etwa 5-10 Minuten, abhängig von deiner Internetgeschwindigkeit.

Du siehst während der Installation verschiedene Fortschrittsmeldungen. Am Ende zeigt das Script dir die zugewiesene IP-Adresse und den Zugangslink zur Home Assistant Web-Oberfläche.

Erweiterte Installation (für individuelle Anpassungen)

Falls du spezifische Einstellungen vornehmen möchtest, wähle „Advanced“ wenn das Script danach fragt. Du durchläufst dann einen interaktiven Dialog mit verschiedenen Optionen.

VM ID festlegen

Das Script fragt dich nach einer VM ID. Gib eine noch nicht verwendete ID ein, zum Beispiel 100, 150 oder eine andere Zahl zwischen 100 und 999999999. Drücke Enter.

Falls die ID bereits verwendet wird, informiert dich das Script und fragt nach einer anderen ID.

VM Name vergeben

Standardmäßig heißt die VM „haos“. Du kannst einen anderen Namen eingeben, zum Beispiel „homeassistant“ oder „smarthome“. Vermeide Leerzeichen und Sonderzeichen. Drücke Enter.

Privileged Container (LXC-spezifisch)

Diese Frage erscheint nur bei LXC-Installationen, nicht bei der HAOS-VM. Du kannst sie überspringen oder mit „No“ beantworten.

CPU Kerne zuweisen

Das Script fragt, wie viele CPU-Kerne du zuweisen möchtest. Die Standardeinstellung ist 2, was für die meisten Installationen ausreicht. Wenn du mehr Performance möchtest oder viele Add-ons nutzen wirst, kannst du 4 oder mehr Kerne zuweisen.

Gib die Anzahl ein und drücke Enter.

RAM zuweisen

Die Standardeinstellung ist 4096 MB (4 GB). Dies ist das empfohlene Minimum für Home Assistant. Wenn du viele Add-ons, Kameras oder eine große Datenbank nutzen wirst, kannst du 8192 MB (8 GB) oder mehr zuweisen.

Gib den Wert in MB ein und drücke Enter.

Disk-Größe festlegen

Standard sind 32 GB, was für die meisten Installationen ausreichend ist. Falls du jedoch viele Kamera-Aufnahmen speichern oder eine große Historie behalten möchtest, kannst du 64 GB oder mehr wählen.

Gib die Größe in GB ein und drücke Enter.

Storage auswählen

Das Script zeigt dir alle verfügbaren Storage-Optionen auf deinem Proxmox-Server an. Wähle den Storage aus, auf dem die VM gespeichert werden soll. Normalerweise ist das „local-lvm“ oder „local-zfs“.

Falls du mehrere Storages hast, wähle den schnellsten (idealerweise SSD/NVMe) für beste Performance.

Bridge-Netzwerk wählen

Standard ist vmbr0, das primäre Bridge-Interface deines Proxmox-Servers. Falls du mehrere Bridges konfiguriert hast oder VLANs nutzt, kannst du hier die entsprechende Bridge auswählen.

Gib den Bridge-Namen ein (z.B. vmbr0, vmbr1) und drücke Enter.

MAC-Adresse

Das Script fragt, ob du eine spezifische MAC-Adresse zuweisen möchtest. In den meisten Fällen kannst du „No“ wählen, dann wird automatisch eine zufällige MAC generiert.

Eine feste MAC ist nur nötig, wenn du DHCP-Reservierungen basierend auf MAC-Adressen nutzt oder die VM später auf einen anderen Host migrieren möchtest.

VLAN Tag (optional)

Falls du VLANs in deinem Netzwerk nutzt, kannst du hier ein VLAN-Tag eingeben. Die meisten Nutzer können dies leer lassen oder „No“ wählen.

MTU-Größe

Die MTU (Maximum Transmission Unit) kannst du normalerweise auf Standard belassen. Nur in speziellen Netzwerk-Setups (z.B. mit Jumbo Frames) musst du hier Anpassungen vornehmen.

Wähle „No“ für Standard oder gib einen spezifischen Wert ein.

Start on Boot

Das Script fragt, ob die VM beim Proxmox-Start automatisch starten soll. Dies ist sehr empfehlenswert, damit Home Assistant nach einem Stromausfall oder Server-Neustart automatisch wieder verfügbar ist.

Wähle „Yes“.

IPv6 aktivieren (optional)

Falls dein Netzwerk IPv6 unterstützt und du dies nutzen möchtest, kannst du es hier aktivieren. Die meisten Heimnetzwerke nutzen nur IPv4, daher kannst du „No“ wählen.

Zusammenfassung und Bestätigung

Das Script zeigt dir eine Zusammenfassung aller gewählten Einstellungen. Überprüfe diese sorgfältig. Falls alles korrekt ist, bestätige mit „Yes“ um die Installation zu starten.

Falls du Änderungen vornehmen möchtest, wähle „No“ und das Script startet den Dialog erneut.

Installations-Prozess

Nach der Bestätigung startet der automatische Installations-Prozess. Du siehst verschiedene Statusmeldungen:

Phase 1: Image-Download Das Script lädt das neueste HAOS-Image von GitHub herunter. Du siehst einen Fortschrittsbalken. Bei schneller Internetverbindung dauert dies 1-2 Minuten.

Phase 2: VM-Erstellung Das Script erstellt die virtuelle Maschine mit deinen gewählten Einstellungen. Es konfiguriert CPU, RAM, Netzwerk und UEFI-Boot automatisch.

Phase 3: Disk-Import Das heruntergeladene HAOS-Image wird als Disk importiert und zur VM hinzugefügt. Dies dauert einige Minuten.

Phase 4: Finalisierung Das Script optimiert die VM-Einstellungen, setzt die Boot-Order und aktiviert den QEMU Guest Agent.

Phase 5: VM-Start Die VM wird automatisch gestartet. HAOS bootet jetzt zum ersten Mal.

Am Ende zeigt das Script eine Erfolgsmeldung mit der IP-Adresse und dem Zugangslink.

Nach der Installation

Das Script zeigt dir am Ende eine Meldung wie:

✓ Completed Successfully!
✓ Home Assistant is running at: http://192.168.1.100:8123

Notiere dir diese IP-Adresse oder den Link.

Erste Anmeldung

Öffne deinen Browser und gib die angezeigte Adresse ein. Alternativ kannst du auch versuchen:

http://homeassistant.local:8123

Beim ersten Aufruf kann es noch 2-5 Minuten dauern, bis Home Assistant vollständig gestartet ist. Du siehst dann entweder einen „Preparing Home Assistant“ Bildschirm oder direkt den Onboarding-Prozess.

Falls die Seite nicht lädt, warte noch ein paar Minuten. Der erste Boot benötigt Zeit für die Initialisierung aller Komponenten.

Onboarding durchführen

Wenn Home Assistant bereit ist, erscheint der Willkommensbildschirm:

1. Benutzer erstellen: Gib deinen Namen, Benutzernamen und ein sicheres Passwort ein
2. Standort festlegen: Trage deine Adresse ein für Wetter und Zeitzonen
3. Statistiken: Entscheide, ob du anonyme Statistiken teilen möchtest
4. Geräte finden: Home Assistant scannt automatisch dein Netzwerk

Nach dem Onboarding bist du im Home Assistant Dashboard und kannst mit der Konfiguration beginnen.

VM in Proxmox verwalten

Die erstellte VM findest du in der Proxmox Web-Oberfläche in der linken Seitenleiste unter der von dir gewählten ID.

VM-Konsole öffnen

Klicke auf die VM und dann auf „Console“. Hier siehst du die Home Assistant OS Konsole. Du kannst dich dort mit „root“ anmelden (kein Passwort erforderlich) für erweiterte Diagnose.

Ressourcen anpassen

Falls du später mehr Ressourcen benötigst:

• Klicke auf Hardware
• Wähle Memory oder Processors
• Klicke Edit und passe die Werte an
• Starte die VM neu

Snapshots erstellen

Bevor du größere Änderungen vornimmst:

• Rechtsklick auf die VM → Snapshot
• Gib einen aussagekräftigen Namen ein
• Take Snapshot

USB-Geräte hinzufügen

Falls du Zigbee-Sticks oder andere USB-Geräte nutzen möchtest:

• Finde die USB-ID auf Proxmox mit: lsusb
• Hardware → Add → USB Device
• Wähle dein Gerät aus
• Starte die VM neu

Updates durchführen

Home Assistant Updates

Home Assistant zeigt Updates automatisch an:

• Settings → System → Updates
• Klicke auf Update
• Warte bis abgeschlossen

HAOS Updates

Das Betriebssystem wird ebenfalls über die Home Assistant Oberfläche aktualisiert:

• Settings → System → Updates
• Unter „Operating System“ siehst du verfügbare Updates
• Klicke Update

VM mit Helper Script aktualisieren

Du kannst das Helper Script auch für Updates nutzen:

bash -c "$(wget -qLO - https://github.com/tteck/Proxmox/raw/main/vm/haos-vm.sh)"

Das Script erkennt bestehende Installationen und bietet Update-Optionen an.

Weitere Helper Scripts

Die Community bietet viele weitere nützliche Scripts für Proxmox:

Script-Übersicht aufrufen

Um alle verfügbaren Scripts zu sehen:

bash -c "$(wget -qLO - https://github.com/tteck/Proxmox/raw/main/misc/update-all.sh)"

Beliebte zusätzliche Scripts

Mosquitto MQTT Broker:

bash -c "$(wget -qLO - https://github.com/tteck/Proxmox/raw/main/ct/mqtt.sh)"

Zigbee2MQTT:

bash -c "$(wget -qLO - https://github.com/tteck/Proxmox/raw/main/ct/zigbee2mqtt.sh)"

Node-RED:

bash -c "$(wget -qLO - https://github.com/tteck/Proxmox/raw/main/ct/node-red.sh)"

ESPHome:

bash -c "$(wget -qLO - https://github.com/tteck/Proxmox/raw/main/ct/esphome.sh)"

Diese Scripts erstellen jeweils optimierte LXC-Container für die jeweiligen Dienste.

Fehlerbehebung

Script lädt nicht

Falls das Script nicht heruntergeladen werden kann:

• Überprüfe die Internetverbindung deines Proxmox-Servers
• Teste mit: ping google.com
• Überprüfe DNS-Einstellungen
• Stelle sicher, dass wget installiert ist

VM startet nicht

• Öffne die Proxmox Console und überprüfe Fehlermeldungen
• Stelle sicher, dass genug Ressourcen verfügbar sind
• Überprüfe den Task-Log in Proxmox
• Prüfe, ob UEFI korrekt aktiviert ist

Keine IP-Adresse

Falls die VM keine IP erhält:

• Überprüfe die Bridge-Konfiguration
• Stelle sicher, dass DHCP im Netzwerk funktioniert
• Prüfe in der VM-Console die Netzwerk-Einstellungen
• Teste mit einem anderen Bridge-Interface

Home Assistant nicht erreichbar

• Warte 5-10 Minuten beim ersten Start
• Überprüfe in Proxmox Summary, ob die VM läuft
• Prüfe die IP-Adresse in der Console
• Teste Ping zur VM-IP
• Überprüfe Firewall-Regeln

Vorteile des Helper Scripts zusammengefasst

Das Helper Script ist die schnellste und sicherste Methode zur Installation. Es verhindert typische Fehler, nutzt immer die neueste HAOS-Version und konfiguriert die VM optimal. Die Installation dauert nur wenige Minuten statt der manuellen 20-30 Minuten. Zudem bietet es Update-Funktionen und ist sehr gut dokumentiert.

Für die meisten Nutzer ist das Helper Script die beste Wahl – schnell, zuverlässig und einfach.

Home Assistant läuft in wenigen Minuten dank Helper Script.

 

Installation per SSH

Image herunterladen

Öffne die offizielle Home Assistant Webseite und navigiere zum Download-Bereich. Wähle unter den Installationsmethoden „Proxmox VE“ aus. Du siehst dort einen Download-Link für das QCOW2-Image. Die Datei heißt etwa „haos_ova-11.5.qcow2.xz“ – die Versionsnummer kann variieren, wähle immer die neueste stabile Version.

Lade diese Datei entweder auf deinen Computer herunter oder kopiere den Download-Link für den späteren direkten Download auf Proxmox.

Vorbereitung auf Proxmox

Verbinde dich per SSH mit deinem Proxmox-Server. Nutze dafür einen SSH-Client wie PuTTY auf Windows oder das Terminal auf Linux/Mac. Der Befehl lautet: ssh root@DEINE-PROXMOX-IP

Nach erfolgreicher Anmeldung wechselst du ins temporäre Verzeichnis, um dort das Image herunterzuladen. Nutze den Befehl: cd /tmp

Jetzt lädst du das Image direkt auf Proxmox herunter. Verwende wget mit dem Link von der Home Assistant Webseite. Beispiel: wget https://github.com/home-assistant/operating-system/releases/download/11.5/haos_ova-11.5.qcow2.xz

Der Download dauert je nach Internetverbindung einige Minuten. Das Image ist etwa 400-600 MB groß.

Nach dem Download entpackst du das Archiv mit dem Befehl: unxz haos_ova-11.5.qcow2.xz

Dies erzeugt die entpackte QCOW2-Datei, die du für die VM-Installation benötigst.

VM-ID festlegen

Bevor du die VM erstellst, überlege dir eine VM-ID. Proxmox nutzt IDs zur eindeutigen Identifikation von VMs. Die ID muss zwischen 100 und 999999999 liegen. Wenn du bereits VMs hast, wähle eine noch nicht verwendete ID. In dieser Anleitung nutzen wir die ID 100 – passe sie bei Bedarf an.

VM erstellen

Jetzt erstellst du die virtuelle Maschine mit dem Befehl: qm create 100 –name „HomeAssistant“ –memory 4096 –cores 2 –net0 virtio,bridge=vmbr0 –bios ovmf

Was bedeutet dieser Befehl im Detail:

• qm create 100: Erstellt eine VM mit der ID 100
• –name „HomeAssistant“: Setzt den Namen auf HomeAssistant
• –memory 4096: Weist 4 GB RAM zu (4096 MB)
• –cores 2: Weist 2 CPU-Kerne zu
• –net0 virtio,bridge=vmbr0: Erstellt eine Netzwerkschnittstelle mit VirtIO-Treiber an der Bridge vmbr0
• –bios ovmf: Verwendet UEFI statt BIOS

Falls du ein anderes Bridge-Interface nutzt, ändere vmbr0 entsprechend. Falls du mehr Ressourcen zur Verfügung hast, kannst du auch 4 Cores oder 8192 MB RAM zuweisen.

EFI-Disk erstellen

UEFI-Systeme benötigen eine spezielle EFI-Partition. Erstelle diese mit: qm set 100 –efidisk0 local-lvm:1,efitype=4m,pre-enrolled-keys=1

Erklärung:

• –efidisk0: Erstellt die erste EFI-Disk
• local-lvm:1: Speichert sie auf dem Storage „local-lvm“ mit 1 GB Größe
• efitype=4m: Verwendet den 4M-EFI-Typ
• pre-enrolled-keys=1: Nutzt vorinstallierte Secure-Boot-Keys

Falls dein Storage anders heißt (z.B. „local-zfs“ oder „storage1“), passe „local-lvm“ entsprechend an.

Image als VM-Disk importieren

Jetzt importierst du das heruntergeladene HAOS-Image als Festplatte für deine VM: qm importdisk 100 /tmp/haos_ova-11.5.qcow2 local-lvm

Dieser Vorgang dauert ein paar Minuten, da das komplette Image auf deinen Proxmox-Storage kopiert wird. Der Befehl gibt dir am Ende eine Erfolgsmeldung mit der neuen Disk-Bezeichnung, etwa „vm-100-disk-0“.

Auch hier gilt: Passe „local-lvm“ an deinen Storage-Namen an, falls erforderlich.

Disk zur VM hinzufügen

Die importierte Disk existiert jetzt, ist aber noch nicht mit der VM verbunden. Füge sie als SCSI-Disk hinzu: qm set 100 –scsihw virtio-scsi-pci –scsi0 local-lvm:vm-100-disk-0

Erklärung:

• –scsihw virtio-scsi-pci: Setzt den SCSI-Controller auf VirtIO
• –scsi0 local-lvm:vm-100-disk-0: Verbindet die importierte Disk als erste SCSI-Disk

Falls die Disk-Bezeichnung abweicht (z.B. vm-100-disk-1), passe sie entsprechend an.

Boot-Reihenfolge konfigurieren

Stelle sicher, dass die VM von der richtigen Disk bootet: qm set 100 –boot order=scsi0

Dies setzt die SCSI-Disk als primäres Boot-Device. Ohne diese Einstellung würde die VM nicht starten.

CPU optimieren

Für bessere Performance stellst du den CPU-Typ auf „host“: qm set 100 –cpu host

Dies ermöglicht der VM den Zugriff auf alle CPU-Features deines Prozessors, was die Performance deutlich verbessert. Nur bei Problemen solltest du auf „kvm64“ oder einen anderen Typ zurückgreifen.

Autostart aktivieren (optional)

Wenn Home Assistant automatisch beim Proxmox-Start hochfahren soll: qm set 100 –onboot 1

Dies ist besonders praktisch nach einem Stromausfall oder Server-Neustart. Die VM startet dann automatisch.

VM starten

Starte die VM mit: qm start 100

Die VM bootet jetzt. Du kannst den Boot-Vorgang in der Proxmox-Konsole verfolgen, wenn du möchtest.

Alternative: Installation über Web-Interface

Falls du die Installation lieber über die grafische Oberfläche durchführen möchtest, öffne die Proxmox Web-UI in deinem Browser. Die Adresse lautet: https://DEINE-PROXMOX-IP:8006

Melde dich mit deinen Proxmox-Zugangsdaten an.

Schritt 1: VM erstellen

Klicke oben rechts auf den blauen Button „Create VM“. Es öffnet sich ein mehrstufiger Wizard.

General Tab:

• Node: Wähle deinen Proxmox-Node aus (falls mehrere vorhanden)
• VM ID: Gib eine freie ID ein, z.B. 100
• Name: Gib „HomeAssistant“ ein (ohne Leerzeichen)
• Klicke „Next“

OS Tab:

• Wähle „Do not use any media“
• Klicke „Next“

Diese Auswahl ist wichtig, da wir später eine Disk importieren und nicht von einem ISO-Image installieren.

System Tab:

• Graphic card: Belasse auf „Default“
• Machine: Wähle „q35“ (empfohlen für moderne Systeme)
• BIOS: Wähle „OVMF (UEFI)“
• Add EFI Disk: Häkchen setzen
• EFI Storage: Wähle deinen Storage, z.B. „local-lvm“
• SCSI Controller: Wähle „VirtIO SCSI“
• Qemu Agent: Kann aktiviert bleiben, wird später in Home Assistant nutzbar
• Klicke „Next“

Disks Tab:

• Falls eine Disk automatisch hinzugefügt wurde: Klicke auf die Disk und dann „Remove“
• Wir brauchen hier erstmal keine Disk, da wir sie später importieren
• Klicke „Next“

CPU Tab:

• Sockets: 1
• Cores: 2 (oder mehr, je nach verfügbaren Ressourcen)
• Type: „host“ für beste Performance (oder „x86-64-v2-AES“ für Kompatibilität)
• Klicke „Next“

Memory Tab:

• Memory (MiB): 4096 (entspricht 4 GB)
• Minimum memory: Kann leer bleiben
• Ballooning Device: Kann aktiviert bleiben
• Klicke „Next“

Network Tab:

• Bridge: vmbr0 (oder dein verwendetes Bridge-Interface)
• VLAN Tag: Leer lassen (außer du nutzt VLANs)
• Model: VirtIO (paravirtualized)
• MAC address: Automatisch generiert belassen
• Firewall: Kann aktiviert werden, wenn du die Proxmox-Firewall nutzt
• Klicke „Next“

Confirm Tab:

• Überprüfe alle Einstellungen
• Häkchen bei „Start after created“ NICHT setzen (wir müssen erst die Disk importieren)
• Klicke „Finish“

Schritt 2: Disk importieren

Die VM ist jetzt erstellt, aber ohne Boot-Disk. Jetzt musst du das Image importieren.

Wechsle zu deinem SSH-Terminal und führe den Import aus:

• Gehe ins tmp-Verzeichnis: cd /tmp
• Lade das Image herunter (falls noch nicht geschehen): wget https://github.com/home-assistant/operating-system/releases/download/11.5/haos_ova-11.5.qcow2.xz
• Entpacke es: unxz haos_ova-11.5.qcow2.xz
• Importiere die Disk: qm importdisk 100 /tmp/haos_ova-11.5.qcow2 local-lvm

Warte, bis der Import abgeschlossen ist.

Schritt 3: Disk zur VM hinzufügen

Gehe zurück zur Proxmox Web-UI:

• Wähle deine VM (100 HomeAssistant) in der linken Seitenleiste aus
• Klicke auf „Hardware“
• Du siehst jetzt einen Eintrag „Unused Disk 0“ mit etwa 32 GB Größe
• Doppelklick auf „Unused Disk 0“ oder Rechtsklick → „Edit“
• Im Dialog: Klicke einfach „Add“ (die Standardeinstellungen passen)
• Die Disk erscheint jetzt als „scsi0“ in der Hardware-Liste

Schritt 4: Boot-Reihenfolge einstellen

• Klicke auf „Options“ im VM-Menü
• Doppelklick auf „Boot Order“ oder Rechtsklick → „Edit“
• Setze ein Häkchen bei „scsi0“
• Ziehe „scsi0“ ganz nach oben in der Liste
• Klicke „OK“

Schritt 5: VM starten

• Klicke auf den grünen „Start“ Button oben rechts
• Optional: Klicke auf „Console“ um den Boot-Vorgang zu verfolgen

Erster Boot und Wartezeit

Egal ob du die VM per SSH oder Web-UI erstellt hast – der erste Boot dauert länger als normale Starts. Home Assistant muss beim ersten Start viele Komponenten initialisieren und konfigurieren.

Du siehst in der Console verschiedene Boot-Meldungen. Der Prozess durchläuft mehrere Phasen:

1. UEFI-Boot (wenige Sekunden)
2. Home Assistant OS lädt (etwa 30 Sekunden)
3. Home Assistant Core wird gestartet (1-2 Minuten)
4. Alle Komponenten werden initialisiert (1-3 Minuten)

Insgesamt solltest du nach 2-5 Minuten Zugriff haben. Bei älteren Hardware kann es auch 10 Minuten dauern.

IP-Adresse herausfinden

Home Assistant sollte automatisch per DHCP eine IP-Adresse von deinem Router erhalten. Es gibt mehrere Wege, diese herauszufinden:

Methode 1: Proxmox Summary

• Gehe in der Proxmox Web-UI zu deiner VM
• Klicke auf „Summary“
• Unter „IPs“ siehst du die zugewiesene IP-Adresse (kann ein paar Minuten dauern, bis sie erscheint)

Methode 2: Proxmox Console

• Öffne die Console der VM
• Warte bis du die Login-Eingabeaufforderung siehst
• Dort wird oft die IP-Adresse angezeigt

Methode 3: Router-Interface

• Logge dich in deinen Router ein
• Suche in der DHCP-Client-Liste nach „homeassistant“
• Notiere die IP-Adresse

Methode 4: IP-Scanner

• Nutze ein Tool wie „Advanced IP Scanner“ (Windows) oder „nmap“ (Linux)
• Scanne dein Netzwerk
• Suche nach einem Gerät mit dem Namen „homeassistant“

Zugriff auf Home Assistant

Öffne deinen bevorzugten Webbrowser und gib eine der folgenden Adressen ein:

Mit mDNS (empfohlen): http://homeassistant.local:8123

Dies funktioniert, wenn dein Netzwerk mDNS unterstützt (die meisten modernen Netzwerke tun dies).

Mit IP-Adresse: http://DEINE-VM-IP:8123

Beispiel: http://192.168.1.150:8123

Falls die Seite noch nicht lädt, warte noch 1-2 Minuten. Der erste Start kann etwas länger dauern.

Onboarding – Erste Einrichtung

Wenn die Home Assistant Oberfläche lädt, siehst du den Willkommensbildschirm.

Schritt 1: Benutzer erstellen

• Name: Dein vollständiger Name (wird in der Oberfläche angezeigt)
• Benutzername: Login-Name (Kleinbuchstaben, keine Leerzeichen)
• Passwort: Wähle ein sicheres Passwort
• Passwort bestätigen: Wiederhole das Passwort
• Klicke „Create Account“

Schritt 2: Standort festlegen

• Trage deine Adresse oder Stadt ein
• Home Assistant findet deinen genauen Standort auf der Karte
• Dies wird für Wetter, Sonnenauf-/untergang und Zeitzonen genutzt
• Du kannst die Marker-Position präzise anpassen
• Klicke „Next“

Schritt 3: Statistiken (optional)

• Home Assistant fragt, ob du anonyme Nutzungsstatistiken teilen möchtest
• Dies hilft den Entwicklern, ist aber komplett optional
• Wähle „Yes“ oder „No“ je nach Präferenz
• Klicke „Next“

Schritt 4: Automatische Geräteerkennung

• Home Assistant scannt jetzt dein Netzwerk nach kompatiblen Geräten
• Dies kann einige Sekunden bis Minuten dauern
• Gefundene Geräte werden aufgelistet
• Du kannst sie direkt hinzufügen oder später in den Einstellungen
• Klicke „Finish“

Fertig! Du bist jetzt im Home Assistant Dashboard.

VM optimieren

USB-Geräte durchreichen

Falls du USB-Geräte wie Zigbee-Sticks, Z-Wave-Controller oder andere USB-Hardware nutzen möchtest, musst du diese an die VM durchreichen.

USB-Geräte finden: Verbinde dich per SSH mit Proxmox und gib ein: lsusb

Du siehst eine Liste aller USB-Geräte:

Bus 001 Device 003: ID 1a86:7523 QinHeng Electronics CH340 serial converter
Bus 001 Device 002: ID 10c4:ea60 Silicon Labs CP210x UART Bridge
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub

Notiere dir die ID des gewünschten Geräts. Die ID besteht aus zwei Teilen, getrennt durch einen Doppelpunkt. Beispiel: 1a86:7523

USB-Gerät per Web-UI durchreichen:

• Wähle deine VM in Proxmox aus
• Klicke auf „Hardware“
• Klicke „Add“ oben → „USB Device“
• Wähle „Use USB Vendor/Device ID“
• Vendor ID: Erster Teil der ID (z.B. 1a86)
• Device ID: Zweiter Teil der ID (z.B. 7523)
• Klicke „Add“

USB-Gerät per SSH durchreichen: qm set 100 –usb0 host=1a86:7523

Starte die VM neu, damit die Änderung wirksam wird. In Home Assistant erscheint das Gerät dann unter /dev/ttyUSB0 oder ähnlich.

Zusätzlichen Speicher hinzufügen

Falls du später mehr Speicherplatz brauchst (z.B. für Aufnahmen von Kameras):

Per SSH: qm set 100 –scsi1 local-lvm:32

Dies fügt eine zusätzliche 32 GB Disk als scsi1 hinzu.

Per Web-UI:

• Hardware → Add → Hard Disk
• Bus/Device: SCSI, Nummer 1
• Storage: local-lvm
• Disk size: 32 (GB)
• Add

In Home Assistant kannst du diese zusätzliche Disk dann formatieren und nutzen. Gehe dazu in Home Assistant zu: Settings → System → Storage

Snapshot erstellen (Backup)

Bevor du größere Änderungen machst, erstelle einen Snapshot:

Per Web-UI:

• Rechtsklick auf deine VM → Snapshot → Take Snapshot
• Name: Gib einen aussagekräftigen Namen ein (z.B. „Fresh Install“ oder „Vor Update“)
• Description: Optional eine Beschreibung
• Include RAM: Nur aktivieren, wenn du den RAM-Zustand sichern willst (größerer Snapshot)
• Take Snapshot

Per SSH: qm snapshot 100 fresh-install –description „Frische Installation vor Konfiguration“

Snapshots sind extrem nützlich für schnelle Rollbacks.

VM-Ressourcen anpassen

Falls Home Assistant später mehr Ressourcen braucht:

Mehr RAM:

• Hardware → Memory → Edit
• Ändere den Wert (z.B. auf 8192 für 8 GB)

Mehr CPU-Kerne:

• Hardware → Processors → Edit
• Ändere Cores (z.B. auf 4)

Diese Änderungen erfordern einen Neustart der VM.

QEMU Guest Agent installieren (optional)

Der QEMU Guest Agent ermöglicht bessere Integration zwischen Proxmox und der VM (z.B. sauberes Herunterfahren, IP-Anzeige).

Home Assistant OS hat den Agent bereits vorinstalliert, du musst ihn nur in Proxmox aktivieren:

Per Web-UI:

• Options → QEMU Guest Agent → Edit
• Häkchen bei „Use QEMU Guest Agent“ setzen
• OK

Per SSH: qm set 100 –agent enabled=1

Nach einem VM-Neustart ist der Agent aktiv.

Fehlerbehebung

VM startet nicht

Überprüfe in der Proxmox Console, ob Fehlermeldungen erscheinen. Häufige Probleme:

• EFI-Disk fehlt: Erstelle sie nachträglich
• Keine Boot-Disk: Überprüfe, ob scsi0 in der Boot-Order aktiv ist
• UEFI nicht aktiviert: Stelle sicher, dass BIOS auf OVMF steht

Home Assistant nicht erreichbar

• Warte 5-10 Minuten beim ersten Start
• Überprüfe die IP-Adresse in Proxmox Summary
• Prüfe, ob die VM läuft (grüner Pfeil in Proxmox)
• Teste Ping zur VM-IP
• Überprüfe Firewall-Einstellungen

USB-Gerät wird nicht erkannt

• Überprüfe, ob die USB-IDs korrekt sind (lsusb)
• Stelle sicher, dass das Gerät nicht von Proxmox selbst genutzt wird
• Starte die VM nach USB-Hinzufügung neu
• Prüfe in Home Assistant unter Settings → System → Hardware

Schlechte Performance

• Erhöhe RAM auf 8 GB
• Füge mehr CPU-Kerne hinzu
• Stelle CPU-Type auf „host“
• Nutze SSD statt HDD für Storage
• Überprüfe Proxmox-Ressourcen (möglicherweise Overcommitment)

Wartung und Updates

Home Assistant Updates

Home Assistant zeigt Updates automatisch in der Oberfläche an:

• Settings → System → Updates
• Klicke auf „Update“ wenn verfügbar
• Warte, bis Update abgeschlossen ist
• VM startet automatisch neu

Proxmox VM-Backup

Erstelle regelmäßige Backups der kompletten VM:

• Rechtsklick auf VM → Backup
• Wähle Backup-Storage
• Compression: ZSTD (empfohlen)
• Mode: Snapshot (für laufende VM) oder Stop (für konsistentere Backups)
• Backup now

Du kannst auch automatische Backup-Jobs unter Datacenter → Backup erstellen.