🏠 Home Assistant

Home Assistant auf Proxmox: Dein Smart Home Server im Eigenbau

Home Assistant auf Proxmox: Dein Smart Home Server im Eigenbau
⚠️ Hinweis: Alle Guides auf smoth.me dienen ausschließlich zu Informations- und Lernzwecken. Die Umsetzung erfolgt auf eigene Gefahr. Wir übernehmen keine Haftung für Schäden, Datenverluste oder Systemausfälle, die durch die Anwendung dieser Anleitungen entstehen können. → Vollständiger Haftungsausschluss

Na, bereit für den nächsten Schritt in deinem Home Lab? Perfekt! Heute tauchen wir tief ein in die Welt der Heimautomatisierung und bauen uns eine robuste Basis für unser Smart Home. Ich zeige dir, wie du Home Assistant sauber und performant auf deinem Proxmox VE Server installierst. Das ist die Königsklasse, wenn du langfristig denkst und nicht nur Home Assistant, sondern auch andere Dienste wie N8N, Pi-hole oder Docker-Container auf einer einzigen Maschine betreiben möchtest.

In meiner Erfahrung ist Proxmox die absolut beste Wahl für ein Home Lab. Es gibt dir die Flexibilität von virtuellen Maschinen (VMs) und LXC-Containern, ohne dass du für jede Anwendung einen eigenen Mini-PC brauchst. Und Home Assistant als VM? Das ist rock-solid und läuft bei mir seit Jahren ohne Murren.

Voraussetzungen – Was du mitbringen solltest

Bevor wir loslegen, lass uns kurz checken, ob du alles am Start hast. Das erspart uns später unnötige Kopfschmerzen, glaub mir!

  • Hardware: Ein Mini-PC oder Server mit mindestens 8 GB RAM (16 GB sind besser, wenn du noch andere VMs/Container planst), einer SSD (mindestens 120 GB, 250 GB+ für Komfort) und einem halbwegs modernen Intel- oder AMD-Prozessor mit Virtualisierungsunterstützung (Intel VT-x / AMD-V). Ein Netzwerkkabel ist Pflicht.
  • USB-Stick: Mindestens 4 GB für das Proxmox-Installationsmedium.
  • Zweiter PC/Laptop: Um den bootfähigen USB-Stick zu erstellen und später auf die Webinterfaces von Proxmox und Home Assistant zuzugreifen.
  • Netzwerkkenntnisse: Grundlegendes Verständnis von IP-Adressen, Subnetzen und wie dein Router funktioniert.
  • Geduld und Neugier: Das ist das Wichtigste! Wir machen hier nichts Kompliziertes, aber es braucht ein bisschen Zeit.

Wichtig zu wissen: Die Installation von Proxmox löscht alle Daten auf der Festplatte deines Ziel-PCs. Stell also sicher, dass dort nichts Wichtiges mehr drauf ist!

Schritt 1: Proxmox VE vorbereiten

Der erste Schritt ist, das Installationsmedium für Proxmox VE zu besorgen und auf einen USB-Stick zu bringen. Das ist unsere Eintrittskarte in die Welt der Virtualisierung.

Proxmox VE ISO herunterladen

Zuerst laden wir die aktuelle Proxmox VE ISO-Datei herunter. Die findest du immer auf der offiziellen Proxmox-Webseite. Ich empfehle dir, immer die neueste stabile Version zu nehmen.

  • Gehe auf: https://www.proxmox.com/
  • Navigiere zum Download-Bereich und lade die Proxmox VE ISO Installer-Datei herunter.

Das ist eine ziemlich große Datei, also gönn dir einen Kaffee, während sie lädt.

Bootfähigen USB-Stick erstellen mit Balena Etcher

Um die ISO-Datei bootfähig auf den USB-Stick zu bekommen, nutzen wir Balena Etcher. Das Tool ist super einfach zu bedienen und funktioniert unter Windows, macOS und Linux gleichermaßen.

  • Lade Balena Etcher herunter von: https://www.balena.io/etcher/
  • Installiere Balena Etcher auf deinem zweiten PC/Laptop.
  • Stecke deinen USB-Stick ein (alle Daten darauf gehen verloren!).
  • Öffne Balena Etcher.
  • Klicke auf "Flash from file" und wähle die eben heruntergeladene Proxmox VE ISO-Datei aus.
  • Klicke auf "Select target" und wähle deinen USB-Stick aus. Achte darauf, den richtigen Stick zu wählen, sonst formatierst du vielleicht aus Versehen deine externe Festplatte!
  • Klicke auf "Flash!" und warte, bis der Vorgang abgeschlossen ist. Das kann ein paar Minuten dauern.

Sobald Etcher fertig ist und "Flash Complete!" anzeigt, kannst du den USB-Stick sicher entfernen.

Schritt 2: BIOS/UEFI-Einstellungen anpassen

Jetzt wird's Hardware-nah! Stecke den vorbereiteten USB-Stick in deinen zukünftigen Proxmox-Server und starte ihn neu. Wir müssen ins BIOS oder UEFI, um ein paar wichtige Einstellungen vorzunehmen.

Die Tasten zum Aufrufen des BIOS/UEFI sind je nach Hersteller unterschiedlich (oft Entf, F2, F10, F12). Halte sie direkt nach dem Einschalten gedrückt. Wenn du es verpasst hast, einfach neu starten und nochmal versuchen.

Secure Boot deaktivieren

Das hat mir viel Zeit gespart: Ein häufiger Stolperstein ist Secure Boot. Die meisten Linux-Distributionen, und Proxmox ist da keine Ausnahme, mögen Secure Boot nicht besonders. Es kann zu Boot-Problemen oder sogar dazu führen, dass die Installation gar nicht erst startet.

  • Suche im BIOS/UEFI nach den Einstellungen für "Boot", "Security" oder "Authentication".
  • Finde die Option "Secure Boot" und deaktiviere sie. Manchmal musst du dafür ein Admin-Passwort setzen oder den "Secure Boot Mode" auf "Custom" stellen, um es dann zu deaktivieren.
  • Speichere die Änderungen und verlasse das BIOS/UEFI.

Bootreihenfolge festlegen

Damit dein Server auch wirklich vom USB-Stick startet, müssen wir die Bootreihenfolge anpassen.

  • Gehe wieder in den "Boot"-Bereich deines BIOS/UEFI.
  • Stelle sicher, dass dein USB-Stick (oft als "USB HDD", "UEFI: [Name des Sticks]" oder ähnlich bezeichnet) an erster Stelle in der Bootreihenfolge steht.
  • Speichere die Änderungen und starte den Server neu.

Wenn alles richtig gemacht wurde, solltest du jetzt den Proxmox VE Installer sehen.

Schritt 3: Proxmox VE installieren

Der Installer ist recht intuitiv, aber ein paar Punkte sind wichtig.

  1. Booten vom USB-Stick: Wähle im Bootmenü des Proxmox Installers die Option "Install Proxmox VE".
  2. Lizenzvereinbarung: Lies sie kurz durch (oder scroll einfach nach unten, ich weiß, wie das ist) und klicke auf "I agree".
  3. Festplattenauswahl: Hier wählst du die Festplatte aus, auf der Proxmox installiert werden soll. Normalerweise ist das deine SSD. Wenn du mehrere Platten hast, wähle die richtige aus! Alle Daten darauf werden gelöscht.
  4. Ländereinstellungen: Wähle dein Land, Zeitzone und Tastaturlayout.
  5. Admin-Passwort und E-Mail: Gib ein sicheres Passwort für den root-Benutzer ein. Dieses Passwort ist super wichtig, merk es dir gut! Die E-Mail-Adresse ist optional, kann aber für Systembenachrichtigungen nützlich sein.
  6. Netzwerkkonfiguration: Das ist ein kritischer Punkt!
    • Hostname: Gib einen Namen für deinen Server ein, z.B. proxmox-server.
    • IP-Adresse: Weise deinem Proxmox-Server eine statische IP-Adresse zu. Das ist extrem wichtig, damit du ihn später immer unter derselben Adresse erreichen kannst. Wähle eine Adresse außerhalb des DHCP-Bereichs deines Routers, z.B. 192.168.1.200/24.
    • Gateway: Das ist die IP-Adresse deines Routers (z.B. 192.168.1.1).
    • DNS-Server: Ich nutze hier gerne die IP meines Routers oder öffentliche DNS-Server wie 1.1.1.1 (Cloudflare) oder 8.8.8.8 (Google).

    Mein Tipp: Schreibe dir die vergebene IP-Adresse und das Root-Passwort unbedingt auf! Du wirst es gleich brauchen.

  7. Zusammenfassung und Start der Installation: Überprüfe noch einmal alle Einstellungen und klicke auf "Install".

Die Installation dauert eine Weile. Dein Server wird mehrmals neu starten. Wenn der Bildschirm dich auffordert, den USB-Stick zu entfernen, tu das und lass den Server dann neu booten. Du solltest dann die Proxmox-Konsole mit der Login-Aufforderung sehen.

Schritt 4: Erster Zugriff auf Proxmox und Vorbereitung

Glückwunsch! Proxmox läuft. Jetzt greifen wir über das Webinterface darauf zu.

Zugriff auf das Proxmox Webinterface

Öffne einen Webbrowser auf deinem zweiten PC/Laptop und gib die IP-Adresse deines Proxmox-Servers ein, gefolgt von Port 8006:

https://[DEINE_PROXMOX_IP]:8006

Du wirst wahrscheinlich eine Sicherheitswarnung im Browser sehen, weil Proxmox ein selbstsigniertes Zertifikat verwendet. Das ist normal und kein Grund zur Sorge. Klicke einfach auf "Erweitert" oder "Trotzdem fortfahren", um zur Login-Seite zu gelangen.

Melde dich an mit:

  • Username: root
  • Password: Das Passwort, das du während der Installation vergeben hast.

Du bist drin! Willkommen in der Proxmox-Oberfläche. Der erste Pop-up, der dich auf eine fehlende Subscription hinweist, kannst du einfach mit OK bestätigen. Das ist nur ein Hinweis, Proxmox ist auch ohne Subscription voll funktionsfähig im Home Lab.

Proxmox Helper Scripts nutzen

Jetzt kommt ein echter Game-Changer für die schnelle Installation von Home Assistant: die Proxmox Helper Scripts. Diese Skripte automatisieren den Prozess des Herunterladens der Home Assistant OS-Disk-Images und der Erstellung der VM. Ich nutze die Skripte von tteck auf GitHub, die sind Gold wert und werden regelmäßig aktualisiert.

Öffne ein Shell-Fenster direkt im Proxmox Webinterface. Wähle dazu links im Baum deinen Proxmox-Server (z.B. proxmox-server) aus und klicke dann oben auf "Shell".

Führe diesen Befehl aus, um das Skript für Home Assistant OS zu starten:

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

Dieses Skript lädt das Home Assistant OS-Image herunter und führt dich interaktiv durch die VM-Erstellung. Es fragt dich nach verschiedenen Parametern:

  • VM ID: Gib eine eindeutige ID ein, z.B. 100.
  • Hostname: Einen Namen für die VM, z.B. homeassistant.
  • CPU Cores: Für Home Assistant reichen 2 Cores meistens aus. Wenn du viele Integrationen oder Add-ons planst, kannst du auch 4 geben.
  • RAM (MB): 4096 MB (4 GB) sind ein guter Startpunkt. Wenn du sehr viele Add-ons hast, kannst du später immer noch erhöhen.
  • Disk Size (GB): 32 GB sind für den Anfang ausreichend. Home Assistant wächst aber mit der Zeit, 64 GB sind komfortabler.
  • Bridge: Wähle hier vmbr0, das ist die Standard-Netzwerkbrücke von Proxmox.

Das Skript erledigt dann den Rest: Es lädt das aktuelle Home Assistant OS-Image herunter, erstellt die VM mit den von dir angegebenen Spezifikationen und hängt das Image als Boot-Disk ein. Das ist wirklich praktisch und spart eine Menge Klicks und mögliche Fehler.

Schritt 5: Home Assistant als VM installieren

Eigentlich haben wir das meiste davon schon mit dem Helper Script erledigt, aber ich möchte dir die Schritte kurz erklären, falls du es mal manuell machen musst oder die Parameter anpassen willst.

Nachdem das Skript durchgelaufen ist, siehst du links in der Proxmox-Oberfläche unter deinem Server-Namen die neu erstellte VM (z.B. mit der ID 100 und dem Namen homeassistant).

Wähle die VM aus und gehe in den Bereich "Hardware". Hier siehst du die vom Skript erstellten Komponenten. Du kannst hier bei Bedarf noch Änderungen vornehmen:

  • Memory: Hier siehst du den zugewiesenen RAM.
  • Processors: Hier siehst du die CPU-Kerne.
  • Hard Disk: Die virtuelle Festplatte.
  • Network Device: Die Netzwerkkarte.

Wichtig zu wissen: Für optimale Performance solltest du unter "Processors" auch "Type" auf host stellen, um die nativen CPU-Features deines Proxmox-Servers an die VM durchzureichen. Das Skript macht das oft schon automatisch. Auch unter "Options" -> "Qemu Agent" würde ich empfehlen, dies auf Yes zu setzen. Das verbessert die Kommunikation zwischen Proxmox und der VM, was für saubere Shutdowns und bessere Überwachung nützlich ist.

Schritt 6: Home Assistant in Betrieb nehmen

Jetzt ist der große Moment gekommen: Wir starten Home Assistant zum ersten Mal!

Erster Start der Home Assistant VM

Wähle deine Home Assistant VM (z.B. 100 (homeassistant)) im Proxmox Webinterface aus und klicke oben rechts auf "Start". Du siehst, wie der Status von "Stopped" auf "Running" wechselt.

Um den Bootvorgang zu verfolgen, klicke auf "Console". Hier siehst du die Bootmeldungen von Home Assistant OS. Es dauert ein paar Minuten, bis alles hochgefahren ist und Home Assistant bereit ist.

Sobald Home Assistant gestartet ist, siehst du in der Konsole eine IP-Adresse, unter der Home Assistant erreichbar ist, z.B. homeassistant.local:8123 oder direkt eine IP-Adresse wie 192.168.1.X:8123.

Zugriff auf das Home Assistant Webinterface

Öffne einen neuen Tab in deinem Webbrowser auf deinem zweiten PC/Laptop und gib die Adresse ein, die dir in der Konsole angezeigt wurde. Meistens ist es:

http://homeassistant.local:8123

oder, falls das nicht funktioniert (manchmal gibt es Probleme mit .local im Netzwerk):

http://[IP_DEINER_HOME_ASSISTANT_VM]:8123

Du solltest jetzt die Willkommensseite von Home Assistant sehen, wo du deinen ersten Benutzer anlegen und die Grundeinstellungen vornehmen kannst. Folge einfach den Anweisungen auf dem Bildschirm, um dein Smart Home einzurichten.

Glückwunsch! Du hast Home Assistant erfolgreich auf Proxmox installiert und den Grundstein für dein Smart Home gelegt. Das ist ein großer Schritt!

Häufige Fehler und Lösungen

In meiner Zeit als Admin bin ich über so manchen Stolperstein gestolpert, den ich dir hier ersparen möchte. Hier sind ein paar typische Probleme und wie du sie löst:

1. Proxmox startet nicht vom USB-Stick

Problem: Du steckst den USB-Stick ein, aber der Server bootet einfach in dein altes Betriebssystem oder meldet "No bootable device found".

Lösung:

  • Secure Boot: Hast du Secure Boot im BIOS/UEFI deaktiviert? Das ist die häufigste Ursache. Prüfe das als Erstes.
  • Bootreihenfolge: Stelle sicher, dass der USB-Stick an erster Stelle in der Bootreihenfolge steht.
  • USB-Port: Versuche einen anderen USB-Port. Manchmal sind nicht alle Ports bootfähig.
  • USB-Stick/Image defekt: Flashe den USB-Stick mit Balena Etcher neu oder versuche einen anderen USB-Stick. Es kann auch vorkommen, dass die heruntergeladene ISO-Datei korrupt ist; lade sie in diesem Fall erneut herunter.

2. Kein Zugriff auf das Proxmox Webinterface nach der Installation

Problem: Du hast Proxmox installiert, aber https://[IP]:8006 funktioniert nicht im Browser.

Lösung:

  • Netzwerkkabel: Ist das Netzwerkkabel wirklich eingesteckt und leuchten die LEDs am Netzwerkport?
  • IP-Adresse: Hast du die korrekte statische IP-Adresse eingegeben? Prüfe in der Proxmox-Konsole (die du direkt am Server siehst) ob die IP-Adresse korrekt angezeigt wird. Du kannst dort auch mit ip a die Netzwerkinterfaces prüfen.
  • Subnetz/Gateway/DNS: Sind Subnetzmaske, Gateway und DNS-Server korrekt konfiguriert und passen zu deinem Heimnetzwerk? Ein falsches Gateway ist ein Klassiker.
  • Firewall: Prüfe, ob dein Router eventuell eine Firewall hat, die den Zugriff blockiert. Das ist aber eher selten bei frischen Installationen im Heimnetz.
  • IP-Konflikt: Hast du aus Versehen eine IP-Adresse vergeben, die bereits von einem anderen Gerät in deinem Netzwerk verwendet wird? Das führt zu unvorhersehbarem Verhalten.

3. Home Assistant VM startet nicht oder ist nicht erreichbar

Problem: Die Home Assistant VM wird in Proxmox als "Running" angezeigt, aber du kannst nicht auf das Webinterface zugreifen oder sie bootet nicht sauber.

Lösung:

  • Console prüfen: Schau in der Proxmox-Konsole der VM nach, was Home Assistant beim Booten ausgibt. Gibt es Fehlermeldungen? Bleibt es hängen? Manchmal braucht es einfach ein bisschen Zeit.
  • Ressourcen: Hast du genug RAM und CPU-Kerne zugewiesen? Für den ersten Start sollten 2 Cores und 4 GB RAM ausreichend sein. Wenn du zu wenig gibst, kann es zu Problemen kommen.
  • Netzwerkbrücke: Ist die Netzwerkkarte der VM korrekt auf vmbr0 (oder die von dir genutzte Bridge) eingestellt?
  • Qemu Agent: Hast du den Qemu Agent in den VM-Optionen aktiviert? Das kann die Stabilität verbessern.
  • IP-Adresse HA: Prüfe in der VM-Konsole die IP-Adresse, die Home Assistant bekommen hat. Ist sie im selben Subnetz wie dein Proxmox-Server?
  • Firewall Proxmox: Standardmäßig ist die Proxmox-Firewall für VMs deaktiviert. Falls du sie aktiviert hast, stelle sicher, dass Port 8123 erlaubt ist.

Fazit und nächste Schritte

Puh, das war ein Ritt! Aber jetzt hast du eine solide Basis für dein Smart Home geschaffen. Home Assistant läuft als VM auf Proxmox, und du hast die volle Kontrolle. Das Schöne an dieser Setup-Methode ist die Flexibilität: Du kannst Snapshots deiner Home Assistant VM machen, sie bei Bedarf einfach migrieren oder andere VMs und Container für weitere Dienste hinzufügen, ohne dass sich die Systeme gegenseitig in die Quere kommen.

Was kommt als Nächstes? Jetzt beginnt der eigentliche Spaß!

  • Geräte integrieren: Füge deine ersten Smart Home Geräte (Lichter, Steckdosen, Sensoren) zu Home Assistant hinzu.
  • Automatisierungen: Erstelle deine ersten Automatisierungen, um dein Zuhause wirklich smart zu machen (z.B. Licht geht an, wenn du nach Hause kommst).
  • Add-ons erkunden: Schau dir die vielen nützlichen Add-ons in Home Assistant an, wie z.B. Mosquitto Broker für MQTT, Samba Share für Dateizugriff oder Node-RED für komplexe Automatisierungen.
  • Backups: Richte regelmäßige Backups deiner Home Assistant VM in Proxmox ein. Das ist super wichtig!
  • Weitere Dienste: Überlege, welche anderen Dienste du in deinem Home Lab hosten möchtest (Pi-hole, N8N, Media Server, etc.) und installiere sie als weitere VMs oder LXC-Container auf deinem Proxmox-Server.

Bleib neugierig, experimentiere und hab Spaß mit deinem neuen Smart Home Server! Wenn du Fragen hast oder auf Probleme stößt, weißt du ja, wo du uns findest.

Weitere Guides aus "Home Assistant"

Instar IN-8815 4K: PoE-Kamera in Home Assistant integrieren
Praxis-Guide zur Integration der Instar IN-8815 4K PoE-Kamera in Home Assistant. Schritt-für-Schritt…
Home Assistant HACS: Dein inoffizieller App Store für mehr Smartness
Dieser Guide zeigt dir, wie du HACS in Home Assistant installierst und nutzt, um dein Smart Home mit…
Home Assistant: Dein System fit machen – Update, SSH, HACS
Dieser Guide zeigt dir, wie du dein frisch installiertes Home Assistant aktualisierst, sicheren SSH-…
Home Assistant Voice: Meine Praxiserfahrungen mit dem Sprachassistenten
Erfahre, wie du den Home Assistant Voice Sprachassistenten in deinem Heimlab einrichtest und optimie…