Fehlerbehebung

Die häufigsten Stolpersteine mit ihrer Ursache und dem Weg heraus. Die meisten davon zeigt der Assistent in Schritt 2 schon selbst an.

Der Assistent verbindet sich nicht

• Die Adresse braucht das Schema und den Port, also http://homeassistant.local:8123, nicht nur homeassistant.local.
• Der Token muss vollständig eingefügt sein. Er ist lang und wird in Home Assistant nur einmal angezeigt. Lege im Zweifel einen neuen an.
• Bei HTTPS mit eigenem Zertifikat öffne Home Assistant zuerst im selben Browser und akzeptiere das Zertifikat, sonst blockt der Browser die Verbindung.
• Der Browser darf die Seite assistent.html nicht aus einem Cloud-Ordner öffnen, der sie erst herunterladen muss. Lege sie lokal ab.

„Nutzerliste nicht lesbar“

Der Token gehört keinem Administrator. Der Assistent legt Dashboards trotzdem an, aber die Rollen bleiben beim Standard. Erzeuge den Token mit einem Administrator-Konto.

„Datei fehlt“ bei /config/www

Die Dateien aus dem Ordner www liegen noch nicht am richtigen Ort oder Home Assistant kennt den Ordner noch nicht. Prüfe den Pfad, er muss /config/www/iw-mobile/iw-mobile-card.js lauten, nicht /config/www/www/…. Gab es den Ordner www vorher nicht, starte Home Assistant einmal neu. Zur Kontrolle rufst du http://deine-instanz:8123/local/iw-brand/mindmap-mask.png im Browser auf.

„Theme fehlt“

Die beiden Dateien liegen nicht unter /config/themes oder die configuration.yaml enthält den Block frontend: themes: !include_dir_merge_named themes noch nicht. Nach dem Eintragen ist ein Neustart nötig. Liegt der Block schon da und du hast nur die Dateien nachgelegt, reicht frontend.reload_themes unter „Entwicklerwerkzeuge“, „Aktionen“.

Rote Karte „Custom element doesn't exist“

Die Ressource für die Karte fehlt oder der Browser hat die Datei noch nicht geladen.

1. Prüfe unter „Einstellungen“, „Dashboards“, Menü oben rechts, „Ressourcen“, ob ein Eintrag /local/iw-mobile/iw-mobile-card.js?v=… existiert. Der Assistent legt ihn in Schritt 5 an.
2. Lade die Seite mit leerem Zwischenspeicher, am Rechner mit Strg und F5, in der Companion App über „Einstellungen“, „Companion App“, „Frontend-Cache zurücksetzen“ oder durch Neustart der App.

Die Karte zeigt einen Einrichtungshinweis

Die Karte sagt dir, welches Pflichtfeld fehlt. Steht dort der Haus-Check-Sensor, ist das Paket noch nicht aktiv. Kopiere itsweber_dashboards.yaml nach /config/packages und starte Home Assistant neu. Prüfe danach unter „Entwicklerwerkzeuge“, „Zustände“, ob sensor.haus_check existiert. Alle anderen Pflichtfelder trägst du im Karten-Editor nach.

Das Paket wird nicht geladen

• Der Block homeassistant: packages: !include_dir_named packages fehlt in der configuration.yaml.
• Die Datei liegt nicht in /config/packages, sondern in einem Unterordner oder direkt in /config.
• Die Konfigurationsprüfung meldet einen Fehler. Öffne „Einstellungen“, „System“, „Protokolle“ nach dem Neustart, dort steht die Zeile, die stört. Häufig ist es eine Entität, die in deiner Instanz einen anderen Namen hat als in der Zuordnung.

Der Desktop zeigt keine oder zu wenige Räume

Räume entstehen aus den Bereichen von Home Assistant. Der Generator baut nur Bereiche, denen bedienbare Geräte oder Messwerte zugeordnet sind. Prüfe unter „Einstellungen“, „Bereiche, Labels und Zonen“, ob deine Leuchten und Sensoren einem Bereich zugeordnet sind. Etagen sind optional, ohne sie landen alle Räume unter „Ohne Etage“. Nach dem Zuordnen lässt du den Assistenten erneut laufen.

Es fehlen Leuchten, andere sind zu viel

Das ist das Label-Prinzip. Sobald eine einzige Leuchte das Label show_dboard trägt, zeigen die Dashboards nur noch Leuchten mit diesem Label. Vergib das Label bei allen Leuchten, die du sehen willst, oder entferne es überall, dann werden wieder alle gezeigt. Details unter Labels.

Kopfzeile und Seitenleiste sind weg, wie bearbeite ich?

Das ist Kiosk Mode, gewollt für den App-Eindruck. Zum Bearbeiten hängst du ?edit=1 an die Adresse. Wenn du die normale Oberfläche einmal sehen willst, hilft ?disable_km.

Die Companion App zeigt den Desktop statt der Handy-Ansicht

Das Standard-Dashboard ist je Gerät einzustellen. Öffne in der App das Mobil-Dashboard, Menü oben rechts, „Als Standard auf diesem Gerät“. Siehe Handy und Tablets einrichten.

Nach einem Update sieht alles aus wie vorher

Browser und Companion App halten Kartendateien lange im Zwischenspeicher. Lass den Assistenten bis Schritt 5 laufen, er trägt die Ressourcen mit neuer Versionsnummer ein. Danach die Seite neu laden oder die App neu starten. Siehe Aktualisieren.

Die Tür-Skripte lehnen ab

Das ist die Rollenprüfung. Das Konto, das den Knopf gedrückt hat, ist als „Kinder“ eingetragen oder hat keine Rolle. Rollen änderst du im Karten-Editor der Mobil-Karte in der Gruppe „Nutzer und Rollen“. Läuft danach das Paket noch mit der alten Zuordnung, lass den Assistenten erneut laufen, er erzeugt das Paket neu, und kopiere es nach /config/packages.

Ich komme nicht weiter

Schreib über das Kontaktformular auf itsweber.de oder in die Kommentare unter dem Blogartikel. Hilfreich sind die Meldung aus dem Assistenten, die Version deines Home Assistant und ein Bild der Karte.