[Neue Integration] HA Housekeeper – Home Assistant verstehen, warten und sicher aufräumen

bertel2020 · 10. Oktober 2026 um 06:37

Hallo zusammen,

ich möchte euch meine neue Custom Integration HA Housekeeper vorstellen. Sie unterstützt bei Inventarisierung, Diagnose, Abhängigkeitsanalyse und kontrollierter Wartung einer Home-Assistant-Installation.

Repository:

Warum Housekeeper?

Home-Assistant-Installationen wachsen mit der Zeit. Geräte werden ersetzt, Entitäten umbenannt, Integrationen entfernt und Automationen immer wieder angepasst. Irgendwann wird es schwierig, Fragen wie diese zuverlässig zu beantworten:

Ist eine Entität wirklich verwaist oder nur vorübergehend nicht verfügbar?
Welche Automationen, Skripte oder Dashboards verwenden sie noch?
Was könnte beim Entfernen eines Geräts beschädigt werden?
Welche Integrationen arbeiten unzuverlässig?
Welche Entitäten verursachen besonders viel Recorder-Last?
Gibt es defekte Verweise, ungenutzte Automationen oder verwaiste Statistiken?

Housekeeper verbindet Informationen aus den Home-Assistant-Registries mit dem Zustand der laufenden Installation und stellt sie in einem eigenen, nur für Administratoren verfügbaren Panel dar.

Wichtige Funktionen

Inventar für Entitäten, Geräte, Integrationen, Bereiche, Etagen, Labels und Automationen
Unterscheidung zwischen aktiv, unbekannt, nicht verfügbar, deaktiviert und verwaist
Analyse von Automationen, Skripten, Szenen, Dashboards, Gruppen und Helfern
Erkennung fehlender Verweise und möglicher Duplikate
Abhängigkeitsgraph und Analyse der Auswirkungen einer Entfernung
Vergleich der Änderungen zwischen mehreren Scans
Analyse von Automationsläufen und Zuverlässigkeit
Recorder-Last und Datenbankdiagnose
Batterieprognosen und eigene Wartungserinnerungen
Export als CSV oder JSON
Deutsche und englische Oberfläche

Sicherheit steht im Mittelpunkt

Housekeeper löscht oder verändert keine Objekte automatisch.

Jede schreibende Aktion beginnt mit einem Plan und einer Vorschau. Abhängig von der Aktion gehören eine ausdrückliche Bestätigung, Quarantäne, ein Home-Assistant-Backup, eine anschließende Prüfung, ein Journal-Eintrag und eine Rückgängig-Möglichkeit zum Ablauf.

Über den serverseitigen Schutzmodus lässt sich festlegen, was Housekeeper tun darf:

Nur lesen
Nur Quarantäne
Bestätigte Änderungen mit Backup
Voller Wartungsmodus

Kritische Objekte wie Schlösser, Alarmanlagen, Rauchmelder und Garagentore benötigen eine zusätzliche Bestätigung. Integrationen und Hubs werden von Housekeeper nicht verändert.

Abhängigkeiten verstehen

Vor dem Entfernen oder Ersetzen eines Objekts kann Housekeeper zeigen, woher es stammt, was es verwendet und welche Beziehungen sicher oder lediglich wahrscheinlich sind.

Installation

HA Housekeeper lässt sich über HACS installieren:

HACS öffnen.
https://github.com/bertel2020/HA-Housekeeper als benutzerdefiniertes Repository hinzufügen.
Als Kategorie Integration auswählen.
HA Housekeeper installieren und Home Assistant neu starten.
Die Integration unter Einstellungen → Geräte & Dienste hinzufügen.
Als Administrator Housekeeper über die Seitenleiste öffnen.

Die aktuelle Version ist v1.0.3 und benötigt Home Assistant 2026.8 oder neuer.

Das Projekt ist noch jung. Rückmeldungen aus echten Installationen sind daher besonders wertvoll. Falsche Befunde, Installationsprobleme und Verbesserungsvorschläge könnt ihr gerne über GitHub Issues melden:

Grüße
Roberto (bertel2020)

DukeNukem · 10. Oktober 2026 um 11:46

Gleichmal Installiert.

Muss mich noch etwas durch die Doku lesen, gut erklärt jedenfalls.

bertel2020 · 10. Oktober 2026 um 12:06

Sehr cool, vielen Dank fürs Ausprobieren! Ich bin gespannt, was Housekeeper bei dir findet. Über Feedback, Ideen oder Fehlermeldungen freue ich mich natürlich jederzeit.

DukeNukem · 10. Oktober 2026 um 13:05

Einiges, zum Glück nichts gravierendes aber das fehlende Backup-Rückspielen z.b.
der Rest sind alte verwaiste Einträge von Geräten was ich so auf die schnelle gesehen habe,
das sehe ich mir aber erst morgen in ruhe an.

Muss jetzt erstmal los…

jayjojayson · 10. Oktober 2026 um 13:07

Habe es auch mal installiert und ist wirklich gut umgesetzt. Hier und da noch etwas unübersichtlich bzw. erschlägt es einen erstmal etwas bis man den Durchblick hat. Aber gefällt mir sehr gut. Würde sich eigentlich gut mit meinem kleine Projekt ergänzen.

Teste gerade mal eine alte Datenreihe aus dem Recorder zu löschen, läuft bisher sauber durch.

Nach dem Durchlauf:

@DukeNukem viel Spaß in deiner Runde heute..

bertel2020 · 10. Oktober 2026 um 13:31

Vielen Dank fürs ausführliche Feedback! Dass die vielen Informationen am Anfang etwas erschlagen können, kann ich gut nachvollziehen – an einer klareren Struktur und besseren Führung möchte ich noch arbeiten.

Freut mich sehr, dass das Löschen der alten Recorder-Datenreihe bisher sauber läuft. Und jetzt bin ich natürlich neugierig: Was ist dein kleines Projekt und wie könnte es Housekeeper ergänzen?

bertel2020 · 11. Oktober 2026 um 15:14

Hallo zusammen,

HA Housekeeper 1.4.0 ist verfügbar. Die neue Version macht defekte Referenzen in Dashboards deutlich leichter verständlich. Dieser Beitrag fasst außerdem die umfangreichen Neuerungen aus Version 1.3 zusammen.

Neu in Version 1.4

Defekte Dashboard-Referenzen in Klartext

Bisher wurden Fundstellen in Dashboards als technische Pfade wie views/12/sections/1/cards/0/… angezeigt. Housekeeper nennt jetzt stattdessen:

den betroffenen Dashboard-Tab,
den Abschnitt,
den Kartentyp,
und die fehlenden Objekte dieser Karte.

Alle defekten Referenzen derselben Karte erscheinen als eine aufklappbare Gruppe. Auch die Diagnose zeigt nun eine Zeile pro Karte statt einer langen Liste einzelner technischer Pfade.

Vorschläge für fehlende Entitäten

Wenn eine Entität nicht mehr existiert, sucht Housekeeper nach vorhandenen Entitäten mit einem ähnlichen Namen und zeigt sie als möglichen Ersatz an.

Diese Vorschläge gibt es für Referenzen in:

Dashboards,
Automationen,
Skripten,
Szenen,
und Helfern.

Housekeeper ersetzt dabei nichts automatisch. Die Vorschläge sollen lediglich helfen, umbenannte oder ausgetauschte Entitäten schneller wiederzufinden.

Verwaiste Dashboard-Karten

Sind mehr als die Hälfte der Referenzen einer Dashboard-Karte defekt, weist Housekeeper darauf hin, dass möglicherweise nicht nur einzelne Referenzen repariert werden müssen, sondern die gesamte Karte entfernt werden kann.

Lange Diagnosewerte werden außerdem nicht mehr mit einem Auslassungszeichen abgeschnitten.

Ebenfalls neu seit Version 1.3

Logbuch und Objektverlauf

Eigene Einträge werden in einem zentralen Logbuch geführt. Sie lassen sich Geräten, Entitäten, Integrationen, Automationen, Skripten und Szenen zuordnen.

Der Reiter „Verlauf“ verbindet:

Logbucheinträge,
Beobachtungen von Housekeeper,
Pläne, in denen das Objekt vorkommt,
und bei Geräten deren Lebenslauf.

Entfernte oder vergessene Geräte werden ebenfalls im Logbuch vermerkt.

Im Scanverlauf können außerdem benannte Scanpunkte angelegt werden. Sie bleiben bis zum Löschen erhalten und dienen als feste Vergleichsbasis.

Neu strukturierte Objektseiten

Die Seiten für Entitäten, Geräte, Integrationen, Automationen, Skripte und Szenen wurden neu geordnet:

Übersicht zeigt Zustand und bekannte Informationen.
Aktionen enthält Werkzeuge und mögliche Änderungen.
Verlauf zeigt die Entwicklung des Objekts.

Die Karte „Bekannt“ nennt die Quelle jeder Information. Richtlinienverstöße erscheinen direkt auf der Übersichtsseite und lassen sich dort untersuchen oder beheben.

Batterieprognosen

Die Batterieansicht ist jetzt eine gemeinsame Tabelle mit:

Prognosen für bis zu 90 Tage,
dem erwarteten Bedarf der nächsten 30 Tage,
dem Gerätenamen zu jedem Sensor,
Batterietypen aus Battery Notes, sofern vorhanden,
und Unterstützung für Geräte ohne Wechselbatterie.

Für CR2016, CR2032 und CR2450 kann Housekeeper den ungefähren Ladestand anhand der gemessenen Spannung als Prozentwert und Balken darstellen.

Überarbeitete Recorder-Analyse

Der Recorder-Bereich wurde in klarere Ansichten aufgeteilt:

Auffälligkeiten bündelt alle Gründe und Schwellenwerte je Entität.
Ereignisse zeigt Häufigkeit, Anteil und Rate pro Tag.
Integrationen zeigen ihre aktivsten Entitäten.
Empfohlene Recorder-Ausschlüsse sind gekennzeichnet.
„Nur Vorschläge“ begrenzt die Liste auf diese Empfehlungen.

Auch das Kürzen alter Verlaufsdaten erklärt genauer, welche Daten entfernt werden können und welche erhalten bleiben.

Richtlinien und Wartungsaktionen

Richtlinienverstöße lassen sich aufklappen und zeigen ihren Grund sowie passende Möglichkeiten wie Umbenennen, Bereich zuweisen, Objekt öffnen oder Ausblenden.

Neu hinzugekommen ist außerdem eine optionale Richtlinie für Entitäts-IDs, die aus einer Geräteadresse wie einer IP-, MAC-, Funk- oder Zigbee-Adresse bestehen.

Die Assistenten für Gerät austauschen, Zähler wechseln und Verweise ersetzen wurden ebenfalls überarbeitet. Objekte können durch Tippen gesucht werden, Prüfungen stehen direkt im Formular und die Vorschau zeigt je Quelle die alte und die neue Zeile.

Beim Entfernen von Entitäten lassen sich Recorder-Daten einzeln auswählen. Daten, die vom Energie-Dashboard benötigt werden, bleiben geschützt.

Wie bisher gilt: Housekeeper analysiert zunächst nur. Änderungen werden erst nach der ausdrücklichen Bestätigung eines Plans ausgeführt.

Update

Das Update kann über HACS installiert werden. Anschließend muss Home Assistant neu gestartet werden.

Vollständiges Änderungsprotokoll:
https://github.com/bertel2020/HA-Housekeeper/releases/tag/v1.4.0

Feedback und Fehlerberichte:
https://github.com/bertel2020/HA-Housekeeper/issues

jayjojayson · 11. Oktober 2026 um 21:07

Hi, sorry hatte gestern keine Zeit mehr. Mein Projekt hat einen ganz ähnlichen Ansatz wie deins, allerdings, gerade was die Fehlersuche angeht, bei weitem nicht so ausgereift. Ich habe zwar auch eine Auflistung, Bewertung und Hinweisefunktion, aber finde dein Projekt da wirklich schon Klasse umgesetzt und es macht da für mich wenig Sinn, mein Projekt weiter zu entwickeln.

Ich war mal so frei und habe ein PR an dich gerichtet, wo ich meine wichtigsten Funktionen in dein Projekt aufgenommen habe.

Was wäre dann neu?

Unter Explore kommen drei neue Ansichten dazu, außerdem ein kleiner Bedienungs-Fix für schmale Bildschirme.

Speicher & System (nur lesend)

Festplatte, RAM, CPU, Swap und Last
Systemspeicher nach Kategorie und die Apps mit CPU, RAM und Daten (mit Supervisor)
Die größten Verbraucher unter /config
Custom Integrations, Custom Cards und Blueprints mit ihrer Größe

Zugriff & Datenfluss

Systemzugriff der Integrationen mit Datenfluss und Risikostufe
Cloud-Datenfluss nach Domain und IoT-Klasse
Rechte der Apps (mit Supervisor)

Sidebar-Button

Ein Menü-Button öffnet die Sidebar von Home Assistant, wenn sie ausgeblendet ist (schmaler Bildschirm oder „immer ausgeblendet“ im Profil). Das Panel ist damit auf einem Tablet keine Sackgasse mehr.

Tokens & Secrets

Listet die Felder aller Config-Einträge, deren Name auf eine Zugangsdaten hinweist (API-Key, Token, Passwort, PIN, Webhook-ID …), mit maskiertem Wert.
Der volle Wert eines Feldes wird nur auf Klick geholt, nur für Administratoren und ein Feld pro Anfrage.
Der Wert wird nicht geloggt, nicht gespeichert, nicht exportiert und verschwindet, sobald die Seite verlassen wird.

Bitte beachten

Tokens & Secrets weicht von Housekeepers Regel ab, keine Zugangsdaten zu lesen. Deshalb liegt es in einem eigenen Commit (529432b) und lässt sich einzeln weglassen. Dazu gehören credentials.py, ws_credentials.py, 74-i18n-credentials.js, 75-credentials.js, ihre Tests und der Eintrag in der Navigation. Wenn dir das zu weit geht, kann ich es aus dem PR nehmen, der Rest bleibt davon unberührt.

Die Ansichten sind von HA Percyta übernommen und mit Housekeepers eigenen Layout-Bausteinen neu gebaut.