Wenn in Home Assistant etwas nicht funktioniert, hilft ein systematisches Vorgehen mehr als wildes Ausprobieren. In diesem Beitrag lernst du, wo du die Ursache findest, wie du Logs liest und was du bei Verbindungsproblemen, Datenbankgröße und langsamer Oberfläche prüfen kannst.

Schritt 1: Das Log lesen

Die wichtigste Quelle ist das Protokoll unter Einstellungen > System > Protokolle. Dort stehen Warnungen und Fehler mit dem Namen der Integration, die sie meldet.

• Lies die erste Fehlermeldung eines Problems, nicht die letzte. Folgefehler sehen oft schlimmer aus, als die Ursache ist.
• Der Name im Log (zum Beispiel homeassistant.components.… oder custom_components.…) verrät, welche Integration betroffen ist. Bei custom_components handelt es sich um eine Erweiterung, die nicht von Home Assistant stammt.
• Über Vollständige Protokolle laden bekommst du auch ältere Einträge.
• Per SSH oder Terminal-App geht es auch mit ha core logs.
• Suche gezielt nach dem Namen der Entity oder Integration, statt das ganze Log zu lesen.

Schritt 2: Konfiguration prüfen

Nach Änderungen an YAML-Dateien: Entwicklerwerkzeuge > YAML > Konfiguration prüfen. Zeigt Home Assistant dort einen Fehler, wird die Konfiguration nicht geladen. Behebe den Fehler, bevor du neu startest.

Zusätzlich lohnt ein Blick unter Einstellungen > System > Reparaturen. Dort sammelt Home Assistant Hinweise auf Probleme, etwa veraltete Einstellungen oder Integrationen mit Fehlern.

Schritt 3: Verursacher eingrenzen

• Nach einem Update: Release Notes lesen, besonders „Breaking Changes“. Bei Problemen das Backup zurückspielen.
• Custom Integrations und Custom Cards: Eine Erweiterung aus HACS ist häufig die Ursache. Deaktiviere verdächtige Erweiterungen testweise und starte neu. Prüfe in HACS, ob ein Update vorliegt.
• Abgesicherter Modus: Home Assistant lässt sich im abgesicherten Modus starten, dabei werden Custom Integrations und Custom Cards nicht geladen. Das ist ein guter Test, ob eine Erweiterung schuld ist. Die Option findest du im Neustart-Dialog.
• Eine Änderung nach der anderen: Ändere nicht mehrere Dinge gleichzeitig, sonst weißt du nicht, was geholfen hat.

Geräte nicht erreichbar

• Netzwerk: Ist die IP-Adresse noch dieselbe? Feste Adressen (DHCP-Reservierung im Router) vermeiden viele Probleme.
• WLAN-Geräte: Router neu starten, Signalstärke und Kanal prüfen.
• Zigbee/Thread: Koordinator mit USB-Verlängerung vom Server abrücken, Router-Geräte ergänzen, Kanäle zu WLAN prüfen.
• Cloud-Integrationen: Prüfe, ob der Anbieter eine Störung hat oder ein Zugang abgelaufen ist.
• Anmeldung abgelaufen: Bei manchen Diensten musst du Zugangsdaten oder Schlüssel nach einiger Zeit erneuern. Im Log steht dann meist ein Authentifizierungsfehler.

Datenbank und Speicherplatz

Home Assistant speichert alle Zustandsänderungen im Recorder. Wichtig zu wissen:

• Der Standard sind 10 Tage Detailverlauf (purge_keep_days).
• Die Datenbank wird automatisch nachts bereinigt (Auto-Purge).
• Wenn die Datenbank sehr groß wird, liegt es meist an Entities, die sehr oft Werte melden. Schließe solche Entities im Recorder aus, wenn du den Verlauf nicht brauchst.
• Langzeitstatistiken, etwa für das Energie-Dashboard, bleiben von der Bereinigung unberührt.
• Den belegten Platz siehst du unter Einstellungen > System > Speicher. Auch lokale Backups, Medien und App-Daten können viel Platz belegen.
• Bei großen Installationen kann eine externe Datenbank (zum Beispiel MariaDB) sinnvoll sein. Das erfordert aber etwas mehr Pflege.

Die Oberfläche ist langsam

Typische Ursachen:

1. SD-Karte: Sie ist oft das schwächste Glied. Eine SSD ist deutlich zuverlässiger und schneller.
2. Zu große Datenbank: Verlauf kürzen, laute Entities ausschließen.
3. Zu schwache Hardware oder zu wenig Arbeitsspeicher: Prüfe die Auslastung unter Einstellungen > System > Hardware.
4. Zu viele Custom Cards oder Dashboards mit sehr vielen Karten: Reduzieren und prüfen, ob es besser wird.
5. Aufwendige Templates und Integrationen, die ständig Daten abfragen.

Backup nicht vergessen

Bevor du etwas Größeres änderst: Backup erstellen und eine Kopie auf einem anderen System speichern. Bei einer VM reicht ein Snapshot. Dann kannst du jederzeit zurück.

Frage im Forum

Damit dir andere schnell helfen können, schreib ein neues Thema mit diesen Angaben:

• Home-Assistant-Version und Installationsart (OS, Container, VM, Hardware)
• Was hast du geändert, bevor das Problem auftrat (Update, neue Integration, Änderung)
• die Fehlermeldung als Text aus dem Log (nicht als Foto), möglichst mit ein paar Zeilen davor und danach
• was du schon probiert hast

Entferne vor dem Posten Passwörter, Tokens, API-Schlüssel und private Adressen aus Logs und Konfigurationen.