Home Assistant: Marketplace-Update scheitert an hacs.json
Kurz gesagt: Seit Home Assistant 2026.11 verlangt der neue Marketplace in jeder installierbaren Version eine hacs.json. Fehlt sie, gibt es keine Updates mehr. Das Projekt läuft weiter, nur der Entwickler kann die Datei nachreichen. Einige Fälle sind noch ungeklärt.
Symbolbild: KI-generiert
Der Marketplace ist seit Home Assistant 2026.11 (erschienen am 4. November) fester Teil der Software und löst das bisherige HACS ab. Nun häufen sich Meldungen, dass Installationen und Updates mit dem Hinweis abbrechen, der gewählten Version fehle die Datei hacs.json. Das berichtet smarthomeassistent.de.
Was dahintersteckt
Die hacs.json ist eine kleine Beschreibungsdatei im Hauptverzeichnis eines GitHub-Projekts. Der Marketplace verlangt sie in jeder Version, die installiert werden soll. Fehlt sie, bleibt ein bereits installiertes Projekt zwar auf der Platte und läuft zunächst weiter, es erhält aber über den Marketplace keine neuen Versionen mehr. Nach Angaben von techzeitgeist.de und raspberry.tips zeigt Home Assistant dazu eine Reparatur-Meldung mit den betroffenen Einträgen an.
Bei manchen Projekten ist die Ursache klar: Der Entwickler hat die Datei nie angelegt. Mehrere haben sie inzwischen nachgereicht, eine neue Version veröffentlicht, und die Installation klappt wieder. Unklar ist ein zweiter Typ von Fällen: Im Fehlerbericht Nr. 191838 bei Home Assistant Core taucht die Meldung auch bei Projekten auf, deren Datei vorhanden ist, genannt werden Adaptive Lighting und Spook. Eine Antwort der Entwickler stand am 14. November noch aus. Das Wartungsupdate 2026.11.1 vom 9. November enthält zwei Marketplace-Korrekturen, aber keine für diesen Fehler.
Das können Sie tun
- Vor dem Update ein Backup anlegen und die Liste der Projekte im Marketplace ansehen, besonders eigene Repositories.
- Im GitHub-Hauptverzeichnis des betroffenen Projekts nachsehen, ob eine
hacs.jsonexistiert. Fehlt sie, den Entwickler über den Issue-Tracker darauf hinweisen. - Bei Integrationen berichten Nutzer, dass sich eine neue Version von Hand in den Ordner
custom_componentskopieren lässt. - Ist die Datei da und der Fehler bleibt: Das Home-Assistant-Protokoll lesen und den Fall im Fehlerbericht von Home Assistant Core ergänzen. Eine bestätigte Lösung gibt es dafür bisher nicht.
Unsere Einordnung
Für Einsteiger ist das ein Grund mehr, die Zahl der Zusatzprojekte klein zu halten. In unserem Home-Assistant-Einsteiger-Ratgeber kommen wir auf einen Start ab 179 Euro UVP mit dem Home Assistant Green, für Zigbee kommt ein Funkstick für 45 Euro UVP dazu. Wer so startet, kommt mit den eingebauten Integrationen weit und ist von dem Fehler nicht betroffen. Betroffen sind vor allem Fortgeschrittene mit vielen Zusatzprojekten aus dem Marketplace. Einen eigenen Langzeittest von Home Assistant haben wir noch nicht, unsere Angaben stützen sich auf die Herstellerdokumentation.
Wer produktiv auf einzelne Projekte angewiesen ist, wartet am besten das nächste Wartungsupdate ab, das laut Home Assistant im Wochentakt freitags erscheinen soll, und spielt Updates nicht blind ein. Ob es den Fehler behebt, ist offen.
- Home Assistant für Einsteiger: Hardware, Kosten, Start (kostet nichts)
- Smart-Home-Funkstandards erklärt: Zigbee, Thread und Matter (kostet nichts)
- Wenn Geräte nicht miteinander reden: Ökosysteme verstehen (kostet nichts)
- Der teuerste Fehler beim Smart-Home-Einstieg (vor dem Kauf)