Home Assistant Green neu installieren: OS per microSD reparieren

Wenn dein Home Assistant Green nach einem fehlerhaften Update, defekten Add-ons oder Dateifehlern nicht mehr startet, hilft meist nur ein sauberer Reset. Da das Betriebssystem fest auf dem internen 32-GB-eMMC-Speicher liegt, nutzt du für die Wiederherstellung den integrierten MicroSD-Kartenslot. In dieser Anleitung zeige ich dir, wie du das Betriebssystem per microSD-Karte neu auf den internen Speicher schreibst.

Das brauchst du

• Hardware: Home Assistant Green, Netzteil (12 V DC), Ethernet-Kabel am Router mit Internetzugang.
• Speichermedium: Eine funktionierende microSD-Karte (der Slot dient ausschließlich für Recovery-Zwecke).
• Software: Das offizielle Installer-Image aus dem GitHub-Repository NabuCasa/buildroot-installer (z. B. green-installer-*.img, ca. 73 MB) sowie ein Flash-Programm auf dem PC. Wer wissen möchte, wie man Images auf Speicherkarten schreibt, findet Orientierung in unserer Hilfe zu Raspberry Pi OS installieren: Anleitung mit dem Imager.
• Optional: Monitor mit HDMI-Kabel zur Diagnose von Fehlermeldungen.

Achtung: Bei einer Neuinstallation wird der interne Speicher überschrieben und bestehende Konfigurationen gehen verloren. Lege daher, wenn möglich, vorher Backups an.

1. Das korrekte Installer-Image besorgen

Lade nicht das reguläre HAOS-Image herunter, sondern das schlanke Green-Installer-Image (ca. 73 MB) von den GitHub-Releases unter NabuCasa/buildroot-installer. Ein vollständiges System-Image auf der microSD würde nicht auf den internen Speicher übertragen, sondern versucht fälschlicherweise direkt von der Karte zu booten.

2. microSD-Karte vorbereiten und flashen

Schreibe das heruntergeladene Image auf deine microSD-Karte. Verwende unbedingt eine einwandfreie, möglichst neue Speicherkarte, da defekte Sektoren den späteren Schreibvorgang auf den internen eMMC-Speicher abbrechen lassen.

3. Wiederherstellung am Home Assistant Green starten

1. Trenne den Home Assistant Green vom Stromnetz.
2. Stecke das Ethernet-Kabel ein. Der Installer benötigt zwingend eine aktive Internetverbindung, um die aktuelle Betriebssystemversion aus dem Stable-Channel nachzuladen.
3. Schiebe die vorbereitete microSD-Karte in den Kartenslot des Green.
4. Schließe das Netzteil wieder an. Das System bootet nun von der Speicherkarte und startet das Skript haos-flash, das den internen Speicher mmcblk0 überschreibt.

4. microSD-Karte entfernen

Sobald der Kopiervorgang abgeschlossen ist, schalten sich die Status-LEDs ab. Trenne das Gerät kurz vom Strom, entnimm die microSD-Karte und starte den Green erneut nur mit Ethernet und Stromkabel.

Funktioniert es?

Nach einiger Zeit bootet das frisch installierte Home Assistant OS. Du erreichst die Ersteinrichtung wie gewohnt im Browser über das lokale Netzwerk.

Wenn es nicht klappt

• Download bricht ab (curl error): Wenn der Installer nach 1 bis 2 Stunden mit Fehlern abbricht, prüfe deine Internetverbindung. Der Installer lädt das OS direkt via GitHub herunter.
• Schreibfehler auf mmcblk: Zeigt ein angeschlossener HDMI-Bildschirm Lesefehler oder bricht haos-flash ab, liegt das Problem fast immer an einer unzuverlässigen microSD-Karte. Tausche die microSD-Karte gegen ein anderes Modell aus.
• System bootet von der Karte statt zu flashen: Du hast das reguläre OS-Image statt des Buildroot-Installers geflasht. Nutze das Image green-installer-*.img.
• Reset bei noch funktionierender CLI: Hast du noch Konsolenzugriff per Tastatur und Monitor, kannst du das System alternativ direkt mit dem Terminal-Befehl zurücksetzen:

os datadisk wipe

os datadisk wipe

Bestätige die Sicherheitsabfrage lokal mit YES, um den internen Speicher ohne microSD-Karte zu bereinigen.

Nach erfolgreicher Neuinstallation kannst du direkt dein letztes Backup einspielen oder ein frisches Smart Home aufbauen.

Quellen: Forum: Home Assistant Community, home-assistant.io, community.home-assistant.io, raspberry.tips, community.simon42.com