Home Assistant dashboard werkt niet goed? Zo los je kaarten en frontendproblemen op

Een Home Assistant-dashboard is vaak het onderdeel dat je dagelijks het meest gebruikt. Juist daarom is het vervelend wanneer een kaart leeg blijft, een knop niet reageert of je de melding Custom element doesn't exist ziet. Soms ontbreekt een custom card, maar vaak gebruikt de browser nog oude bestanden. In deze gids doorlopen we de controles van eenvoudig naar gevorderd.

1. Bepaal waar het probleem zit

Controleer of het probleem op één dashboard, één kaart of in de hele interface voorkomt. Open hetzelfde dashboard op een tweede apparaat of in een andere browser. Werkt het daar wel, dan wijst dat eerder naar cache of browsergegevens dan naar de configuratie van Home Assistant.

2. Vernieuw de frontend en wis de cache

Home Assistant bewaart frontendbestanden in de browser om de interface sneller te laden. Na het installeren, bijwerken of verwijderen van een custom card kan de browser nog een oudere versie gebruiken. Sluit eerst alle Home Assistant-tabbladen en appvensters en open de interface opnieuw. Helpt dat niet, voer dan een harde refresh uit: op Windows en Linux meestal Ctrl + F5 of Ctrl + Shift + R. In de Companion App kun je de frontend opnieuw laden; de precieze opties verschillen per versie.

3. De melding Custom element doesn’t exist

Deze melding betekent meestal dat Home Assistant de JavaScript-code van een custom card niet heeft geladen of geregistreerd. Controleer of de kaart nog geïnstalleerd is en of de resource correct aan het dashboard is toegevoegd. Open de dashboardinstellingen en controleer bij bronnen of het JavaScript-pad overeenkomt met de actuele installatie-instructies van de kaart. Verwijder dubbele of verouderde resources als je hebt vastgesteld dat die niet meer nodig zijn.

4. Controleer compatibiliteit van custom cards

Bekijk de documentatie en release-informatie van de kaart. Controleer of de kaart nog wordt onderhouden en geschikt is voor jouw Home Assistant-versie. Update niet blindelings alle kaarten tegelijk; werk er één bij en test daarna. Home Assistant heeft tegenwoordig een ingebouwde Marketplace voor integraties en frontenduitbreidingen. Apps zijn iets anders: dat zijn afzonderlijke diensten die onder Home Assistant OS met Supervisor draaien.

5. YAML- of configuratiefout

Gebruik je een YAML-dashboard of handmatig aangepaste kaarten, controleer dan de inspringing, dubbele sleutels, aanhalingstekens en entiteits-ID’s. Eén verkeerd geplaatste spatie kan een kaart onleesbaar maken. Vergelijk de foutieve kaart met een werkend voorbeeld en herstel eerst de laatste wijziging. Maak vóór grote wijzigingen een kopie van de YAML of een back-up.

6. De kaart verschijnt, maar toont geen gegevens

Controleer of de gebruikte entiteit nog bestaat en niet unknown of unavailable is. Een entiteit kan zijn hernoemd, verwijderd of door een integratie-update veranderd. Controleer de status via Ontwikkelaarstools en selecteer zo nodig de juiste entiteit opnieuw. Kijk ook naar filters, voorwaarden en de rechten van de gebruiker.

7. Browserconsole gebruiken

Open bij hardnekkige problemen de ontwikkelaarstools van je browser met F12 en kies Console. Herlaad het dashboard en kijk of er rode foutmeldingen verschijnen. Een ontbrekend JavaScript-bestand, een netwerkfout of een niet-geregistreerd component kan je naar de oorzaak leiden. Controleer gegevens voordat je logs of schermafbeeldingen openbaar deelt; de console kan interne URL’s of persoonlijke informatie tonen.

8. Problemen na een Home Assistant-update

Controleer de release notes en kijk of de custom card een update heeft gekregen. Test in een privévenster of andere browser om cacheproblemen uit te sluiten. Voer niet direct een downgrade uit: vaak is een custom card simpelweg nog niet bijgewerkt. Maak een back-up voordat je ingrijpende herstelacties uitvoert.

Checklist

  • Test het dashboard op een tweede apparaat.
  • Sluit Home Assistant volledig en open het opnieuw.
  • Voer een harde refresh uit of wis de specifieke cache.
  • Controleer of de custom card geïnstalleerd en compatibel is.
  • Controleer de dashboardresource en het JavaScript-pad.
  • Controleer YAML, entiteits-ID’s en kaartfilters.
  • Bekijk de browserconsole en Home Assistant-logboeken.
  • Herstel wijzigingen één voor één.

Veelgestelde vragen

Waarom werkt mijn dashboard op mijn telefoon wel en op mijn tablet niet?

De apparaten kunnen verschillende browsercaches, appversies of schermconfiguraties gebruiken. Test een harde refresh en controleer of dezelfde gebruiker en hetzelfde dashboard worden gebruikt.

Moet ik alle custom cards verwijderen?

Nee. Verwijder alleen een kaart wanneer je hebt vastgesteld dat die de oorzaak is of niet meer nodig is. Begin met cache, resourcepad en compatibiliteit.

Conclusie

Begin bij dashboardproblemen met de cache en test op een tweede apparaat. Onderzoek daarna resources, custom cards, entiteiten en configuratie. Met deze volgorde voorkom je dat je werkende dashboards onnodig opnieuw opbouwt.

Bronnen en verder lezen

Deel dit:
Scroll naar boven