Home Assistant: Entitäten umbenennen ohne Fehler
Entity-ID in Home Assistant ändern oder Sensor tauschen, ohne Automationen und Historie zu verlieren: getesteter Ablauf mit Suche nach alten Verweisen.
Von Nathan Base
Du hast einem Sensor einen ordentlichen Namen gegeben oder einen kaputten Temperaturfühler gegen einen neuen getauscht, und plötzlich zeigt das Dashboard „Entität nicht verfügbar“, eine Automation reagiert nicht mehr und die Verlaufskurve beginnt bei null. Das passiert, weil Home Assistant zwei Dinge unterscheidet, die in der Oberfläche direkt nebeneinander stehen: den Namen und die Entitäts-ID. Wer den Unterschied kennt, kann aufräumen, ohne etwas kaputt zu machen.
Alles in dieser Anleitung habe ich mit Home Assistant 2026.11.2 in Docker nachgestellt, mit zwei Template-Sensoren, einer Automation und einem simulierten Sensortausch. Das Verhalten beim Umbenennen und bei der Historie stammt aus diesem Test, nicht nur aus der Doku.
Name und Entitäts-ID: der entscheidende Unterschied
Jede Entität hat einen Namen wie „Temperatur Bad“, den Du im Dashboard siehst, und eine Entitäts-ID wie sensor.temperatur_bad. Automationen, Skripte, Szenen und Dashboards verweisen ausschließlich auf die ID. Daraus folgt die wichtigste Regel dieses Artikels:
- Den Namen kannst Du jederzeit ändern. Es bricht nichts, denn keine Automation kennt ihn.
- Die Entitäts-ID änderst Du nur mit Plan, denn jeder Verweis auf die alte ID läuft danach ins Leere.
Seit Home Assistant 2026.11 ist der Name außerdem kürzer gedacht: Eine Entität heißt nur noch nach dem, was sie misst, also „Temperatur“ statt „Badsensor Temperatur“, und Home Assistant ergänzt Gerät und Bereich dort, wo es nötig ist. Bestehende Entitäts-IDs ändern sich durch diese Umstellung laut Home-Assistant-Blog zur neuen Benennung nicht.
Was beim Umbenennen automatisch passiert und was nicht
Die ID änderst Du unter Einstellungen > Geräte & Dienste > Entitäten. Klick auf die Entität, dann oben rechts auf das Zahnrad. Dort stehen die Felder Name und Entitäts-ID. Nach der Änderung speicherst Du mit Aktualisieren.
In meinem Test passierte dabei Folgendes:
- Die Historie zieht mit um. Nach dem Umbenennen von
sensor.temperatur_badinsensor.bad_temperaturlag der komplette Verlauf unter der neuen ID, die alte ID war leer. Das macht Home Assistant seit Version 2023.4 automatisch. - Automationen werden nicht angepasst. Eine Automation, die auf die alte ID reagierte, stand nach dem Umbenennen unverändert mit der alten ID in der
automations.yamlund löste damit nie mehr aus. Die offizielle Doku zum Anpassen von Entitäten sagt das auch so: Hast Du die ID geändert, musst Du sie in Automationen und Skripten selbst nachziehen. - Das Umbenennen eines Geräts ändert keine Entitäts-IDs. Das ist gewollt, damit Automationen weiterlaufen. Im Drei-Punkte-Menü eines Geräts gibt es allerdings eine Funktion, um die Entitäts-IDs neu zu erstellen (englisch „Recreate entity IDs“). Sie erzeugt neue IDs nach dem aktuellen Schema und hat damit genau die Folgen aus Punkt 2, nur für alle Entitäten des Geräts auf einmal.
Bevor Du eine ID änderst, schau deshalb nach, wo sie verwendet wird. Öffne die Entität per Klick und wähle im Drei-Punkte-Menü oben rechts Zugehörig. Dort listet Home Assistant die Automationen, Skripte und Szenen, die die Entität verwenden. Diese Liste schreibst Du Dir auf, bevor Du speicherst, denn nach dem Umbenennen zeigt sie für die neue ID nichts mehr an.
Einen Sensor tauschen und die Historie behalten
Das ist der Fall, der die meisten Nerven kostet. Der alte Sensor ist defekt, der neue ist gekoppelt und heißt sensor.temperatur_bad_2 oder ähnlich. Die Automationen und die Langzeitkurve hängen aber an sensor.temperatur_bad. Das Ziel: Der neue Sensor übernimmt die alte ID und schreibt den Verlauf einfach weiter.
Die Reihenfolge ist dabei entscheidend:
- Erstelle ein Backup, wie in Home Assistant Backup: Schlüssel, USB-Laufwerk und NAS beschrieben. Der Tausch ist harmlos, aber ein Backup kostet nur eine Minute.
- Entferne das alte Gerät aus seiner Integration, bei Zigbee etwa über
Gerät > Drei-Punkte-Menü > Löschen. Bleibt danach eine Entität mit dem Status „Nicht verfügbar“ übrig, öffne sie überEinstellungen > Geräte & Dienste > Entitäten, klick auf das Zahnrad und dann auf Löschen. - Gib dem neuen Sensor die alte ID. Öffne seine Einstellungen über das Zahnrad, trag im Feld Entitäts-ID die alte ID
sensor.temperatur_badein und klick auf Aktualisieren.
Das war es. In meinem Test enthielt der Verlauf von sensor.temperatur_bad danach die alten Messwerte des defekten Sensors, eine kurze Lücke für die Zeit des Tauschs und direkt anschließend die Werte des neuen Sensors. Die Automation, die auf sensor.temperatur_bad reagiert, läuft ohne Änderung weiter.
Im Log steht dabei eine Warnung, die Dich nicht beunruhigen muss:
Cannot migrate history for entity_id `sensor.temperatur_bad_2` to `sensor.temperatur_bad` because the new entity_id is already in useHome Assistant sagt damit nur, dass es die paar Minuten Verlauf des neuen Sensors unter seiner vorläufigen ID nicht an die alte Historie anhängt, weil dort schon Daten liegen. Genau das wollen wir: Die alte Historie bleibt, und ab jetzt kommen die neuen Werte dazu.
Den häufigsten Fehler macht man in Schritt 2: Viele benennen den alten Sensor erst in sensor.temperatur_bad_alt um, um Platz für den neuen zu schaffen. Weil die Historie beim Umbenennen mitwandert, nimmt der alte Sensor dann seinen ganzen Verlauf mit, und der neue startet unter der richtigen ID trotzdem bei null. Lösch den alten Sensor deshalb, statt ihn umzubenennen.
Meldet Home Assistant beim Speichern, dass die ID bereits vergeben ist, existiert der alte Eintrag noch. Prüf dann in der Entitätsliste, ob die alte Entität wirklich gelöscht ist, und lass Dir mit dem Filter auch ausgeblendete und deaktivierte Entitäten anzeigen.
Verwaiste Verweise finden
Nach einer Umbenennung oder nach einem größeren Umbau lohnt sich eine Suche nach Verweisen, die ins Leere zeigen. Zwei Wege ergänzen sich dabei.
Alle nicht verfügbaren Entitäten auflisten. Öffne Entwicklerwerkzeuge > Template und füge dieses Template ein:
{{ states
| selectattr('state', 'eq', 'unavailable')
| map(attribute='entity_id')
| list }}Rechts erscheint die Liste aller Entitäten, die gerade nicht verfügbar sind. Darunter findest Du alte Einträge, die Du löschen kannst, und Geräte, die tatsächlich ein Funkproblem haben.
Die alte ID in der Konfiguration suchen. Wenn Du per SSH-Add-on oder Terminal Zugriff auf den Ordner /config hast, findet dieser Befehl jede Fundstelle der alten ID, auch in Dashboards, die im Ordner .storage liegen:
grep -rn --exclude="*.db*" --exclude="*.log*" "sensor.temperatur_bad_2" /configErsetze sensor.temperatur_bad_2 durch die ID, nach der Du suchst. Die Optionen --exclude überspringen die Datenbank und die Logdateien. Treffer in automations.yaml, scripts.yaml oder .storage/lovelace musst Du anpassen. Ein Treffer in .storage/core.restore_state ist dagegen nur der zwischengespeicherte letzte Zustand und verschwindet von selbst. In meinem Test zeigte der Befehl die vergessene Automation sofort an. Ob eine Automation tatsächlich wieder auslöst, prüfst Du danach am besten mit den Traces, wie in Home Assistant: Automation löst nicht aus, Fehlersuche beschrieben.
Ein Benennungsschema, das hält
Die meisten Umbenennungen entstehen, weil die erste ID zufällig war, etwa sensor.0x00158d0001a2b3c4_temperature. Leg Dir deshalb früh ein Schema fest und vergib die ID direkt beim Einrichten eines neuen Geräts:
- Raum zuerst, dann Funktion:
sensor.bad_temperatur,sensor.bad_luftfeuchtigkeit,light.wohnzimmer_decke. So stehen alle Entitäten eines Raums in Listen untereinander. - Keine Marken und Modelle in der ID.
sensor.bad_temperaturüberlebt den nächsten Sensortausch,sensor.aqara_bad_temperaturnicht. - Kleinbuchstaben, Ziffern und Unterstriche. Andere Zeichen lässt Home Assistant in der ID ohnehin nicht zu, Umlaute schreibst Du als
ae,oeundue.
Den Namen formulierst Du dagegen so, wie Du ihn lesen möchtest, mit Umlauten und Leerzeichen. Er darf sich jederzeit ändern, die ID möglichst nie. Wenn Du Dich daran hältst, bleibt ein Sensortausch eine Sache von drei Klicks, und Deine Automationen merken davon nichts.
Weiterlesen.
-
Raspberry Pi & LinuxHome Assistant: Automation löst nicht aus, Fehlersuche
Deine Home-Assistant-Automation tut nichts? Mit Traces findest Du die Ursache: Trigger, Bedingung, Modus Einzeln, nicht verfügbare Entität oder Zeitzone.
Nathan Base -
Raspberry Pi & LinuxHome Assistant Backup: Schlüssel, USB-Laufwerk und NAS
Home Assistant richtig sichern: Notfallschlüssel, USB-Laufwerk, NAS und Google Drive, plus fertige Automationen, die fehlende Backups melden.
Nathan Base -
Raspberry Pi & LinuxHome Assistant langsam? Datenbank verkleinern
Die Datenbank von Home Assistant bremst Backups und Verlauf? So findest Du die Datenfresser, stellst den Recorder ein und behältst die Statistiken.
Nathan Base -
Raspberry Pi & LinuxHome Assistant: Waage-Gewicht in Apple Health eintragen
So überträgst Du das Gewicht Deiner Xiaomi-Waage aus Home Assistant per Tipp auf die Mitteilung in Apple Health, mit Messzeit und ohne Zusatz-App.
Nathan Base -
Raspberry Pi & LinuxHeizung smart mit Home Assistant: Thermostate und Fenster
Heizkörperthermostate lokal in Home Assistant: passende Zigbee-Modelle, Heizplan per Zeitplan-Helfer, Fenster-offen-Automation, externer Sensor.
Nathan Base -
Raspberry Pi & LinuxHome Assistant: Benachrichtigung aufs Handy mit Aktionen
Push aus Home Assistant aufs iPhone oder Android-Handy: einfache Nachricht, Kamerabild, Knöpfe zum Antworten und kritische Alarme.
Nathan Base