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.

Das Energie-Dashboard einrichten

Das Energie-Dashboard findest du unter Einstellungen > Dashboards > Energie. Dort legst du fest, welche Sensoren für Netzbezug, Einspeisung, Solarertrag, Batterie, Gas, Wasser und einzelne Geräte stehen.

Wichtig zu wissen:

• Das Dashboard braucht Energiesensoren in kWh, die fortlaufend hochzählen (Zustandsklasse total_increasing), keine reine Momentanleistung in Watt.
• Es baut sich aus Langzeitstatistiken auf. Neue Daten können bis zu einer Stunde brauchen, bis sie erscheinen. Ein leeres Dashboard direkt nach der Einrichtung ist normal.
• Trage einen Strompreis ein, dann berechnet Home Assistant die Kosten automatisch.
• Mit Einzelgeräten (zum Beispiel Steckdosen mit Messfunktion) siehst du, welche Verbraucher wie viel kosten.

Woher kommen die Messwerte?

• Hauptzähler: Je nach Zähler gibt es Lesekopf-Adapter für die Infrarot-Schnittstelle, Zusatzgeräte oder Cloud-Dienste des Herstellers. Lokale Lösungen sind schneller und unabhängiger, Cloud-Lösungen oft einfacher einzurichten, aber seltener aktualisiert.
• Messsteckdosen und Schaltaktoren: Viele liefern Leistung und Verbrauch gleich mit.
• Nur Leistung vorhanden? Dann hilft der Helfer Riemann-Summenintegral: Er rechnet Watt in kWh um und liefert so einen Sensor, den das Energie-Dashboard akzeptiert.
• Tages-, Wochen- und Monatswerte: Dafür gibt es den Helfer Verbrauchszähler (Utility Meter), der einen Zählerstand in Zeiträume aufteilt.

Typische Stolpersteine beim Strom

• Falsche Einheit oder Sensorart: Watt statt kWh, oder ein Sensor ohne passende Zustandsklasse. Dann taucht er in der Auswahl nicht auf.
• Negative Ausschläge oder Sprünge: Wenn ein Zähler kurz auf 0 fällt, werten die Statistiken das als Rücksetzung. Ursache ist oft ein Gerät, das neu startet oder kurz unavailable meldet.
• Cloud-Zähler: Werte kommen nur alle paar Minuten. Für Live-Anzeigen taugt das nicht, für das Energie-Dashboard reicht es meistens.
• Datenbank: Detaildaten werden nach einer einstellbaren Zeit gelöscht (Recorder). Die Langzeitstatistiken für Energiesensoren bleiben davon unberührt, daher funktioniert das Energie-Dashboard auch über Jahre.

Heizung mit Home Assistant steuern

Typisch sind smarte Heizkörperthermostate (zum Beispiel Zigbee-Modelle), die du über Zigbee2MQTT, ZHA oder eine Herstellerintegration einbindest. Jedes Thermostat erscheint als Klima-Entity mit Soll- und Isttemperatur sowie einem Modus (heizen, aus, Auto).

Beliebte Automationen:

• Fenster offen, Heizung aus: Ein Fensterkontakt setzt das Thermostat auf aus oder auf eine niedrige Temperatur. Nach dem Schließen (mit kurzer Wartezeit) geht es zurück.
• Zeitpläne: Absenkung nachts, Aufheizen morgens. Ein Zeitplan-Helfer macht das übersichtlich.
• Anwesenheit: Wenn alle das Haus verlassen, wird abgesenkt.
• Heizperiode: Ein einfacher Schalter (Helfer vom Typ „Schalter“) für die Heizperiode. Im Sommer stellst du alle Thermostate auf aus, im Herbst wieder zurück. Automationen können diesen Schalter als Bedingung prüfen.

Tipps für Thermostate

• Firmware aktuell halten, vor Updates aber Release Notes lesen.
• Temperaturmessung: Das Thermostat misst am Heizkörper, dort ist es meist wärmer als im Raum. Ein zusätzlicher Raumfühler kann die Regelung verbessern. Beachte, dass dafür oft eine Einstellung am Thermostat umgestellt werden muss.
• Fehler im Log: Manche Zigbee-Thermostate melden Einstellungen (zum Beispiel Timer-Modus oder Temperaturquelle), die nicht zu deinem Setup passen. Deaktiviere Entities, die du nicht nutzt, dann verschwinden die Fehlermeldungen.
• Kein Dauerfeuer: Zu häufige Befehle belasten Batterien. Lieber ein paar Minuten Verzögerung einbauen.
• Sommerbetrieb: Prüfe vor dem Abschalten, dass keine Automation die Thermostate wieder einschaltet.

Frage im Forum

Wenn du Hilfe brauchst, schreib hier ein neues Thema und nenne bitte:

• Home-Assistant-Version und die verwendete Integration (Zigbee2MQTT, ZHA, Hersteller)
• Zähler- oder Thermostat-Modell
• die Entity-ID und den Verlauf des Sensors (Screenshot genügt)
• Logeinträge als Text

Zugangsdaten und Tokens bitte vorher entfernen.

Grundlagen: Dashboards, Ansichten und Karten

Ein Dashboard besteht aus einer oder mehreren Ansichten (Tabs), und jede Ansicht enthält Karten (Cards). Neue Dashboards legst du unter Einstellungen > Dashboards an. Du kannst beliebig viele Dashboards erstellen, zum Beispiel eines für Smartphones, eines für das Wandtablet und eines für die Kinderzimmer.

Beim Bearbeiten gibt es zwei Wege: den grafischen Editor und den Roh-Konfigurations-Editor in YAML (Drei-Punkte-Menü oben rechts). Wer fortgeschrittene Optionen braucht, kommt um YAML kaum herum.

Welche Layouts gibt es?

• Masonry: Der klassische Standard. Karten werden in Spalten untereinander gestapelt und fließen automatisch. Gut für Smartphones, aber nicht sehr präzise für gestaltete Oberflächen.
• Sections: Das neuere Raster-Layout mit Abschnitten. Du kannst Karten per Drag & Drop anordnen und über grid_options Spalten und Zeilen vorgeben.
• Panel: Eine einzelne Karte füllt die ganze Ansicht aus. Praktisch zum Beispiel für einen Grundriss oder eine Kamera.
• Sidebar: Eine Hauptspalte plus eine schmalere Seitenspalte.

Für ein Wandtablet mit festem Bildschirm eignet sich ein Layout mit vorhersehbarer Anordnung. Teste das Ergebnis unbedingt direkt auf dem Tablet, denn bei schmaleren Fenstern kann sich das Layout anders verhalten als am PC. Bei Sections-Dashboards mit vielen Custom Cards gab es bei einzelnen Versionen Berichte über verrutschte Karten.

Das Wandtablet vorbereiten

1. Eigenen Benutzer anlegen: Lege unter Einstellungen > Personen einen eigenen Benutzer für das Tablet an, ohne Administratorrechte. So kann niemand am Tablet versehentlich Einstellungen ändern.
2. Eigenes Dashboard für das Tablet erstellen und als Startseite festlegen.
3. Browser im Vollbild: Mit Fully Kiosk Browser (Android) lässt sich das Tablet fest auf eine Adresse einstellen, Bildschirmschoner und Helligkeit steuern und die Bedienung sperren. Alternativ geht auch die Home-Assistant-Companion-App.
4. Dauerstrom und Wärme: Ein Tablet im Dauerbetrieb am Netzteil kann dem Akku schaden. Bei Dauerbetrieb Ladebegrenzung oder eine schaltbare Steckdose nutzen.
5. Zugriff über feste Adresse: Nutze eine stabile Adresse (feste IP oder Domain) als Start-URL.

Kiosk-Modus: Kopfzeile und Seitenleiste ausblenden

Damit das Dashboard wie eine eigene Oberfläche wirkt, blendest du Kopfzeile und Seitenleiste aus. Dafür gibt es die HACS-Erweiterung Kiosk Mode. Nach der Installation trägst du in der Dashboard-Konfiguration einen Block kiosk_mode: ein. Wichtig:

• Die Einstellung gilt pro Dashboard.
• Du kannst sie auf bestimmte Benutzer beschränken, damit die Kopfzeile am PC sichtbar bleibt.
• Mit ?disable_km an der Adresse schaltest du den Kiosk-Modus vorübergehend ab, praktisch zum Bearbeiten.
• Nach Änderungen die Seite neu laden.

Custom Cards über HACS

Mit HACS lassen sich zusätzliche Karten installieren, zum Beispiel für Buttons, Diagramme, Uhren oder Wetter. Beliebt sind unter anderem button-card, mushroom, card-mod und apexcharts-card. Beachte dabei:

• Weniger ist mehr: Installiere nur, was du wirklich nutzt. Jede Karte kann nach Updates Probleme machen.
• Nach größeren Home-Assistant-Updates prüfen, ob die Custom Cards noch funktionieren.
• Lade Karten, die du nicht mehr brauchst, wieder aus HACS und den Ressourcen.
• Mach ein Backup, bevor du viele Karten auf einmal entfernst oder aktualisierst.

Tipps für ein Tablet, das Besucher sehen

• Keine privaten Informationen: Zeige am Wandtablet keine persönlichen Kalendereinträge, Nachrichten oder sensible Daten. Feiertage oder Ferientermine sind unkritisch.
• Admin-Funktionen sperren: Ein Benutzer ohne Adminrechte verhindert Änderungen an den Einstellungen.
• Popups und Rotation: Mit Popups und wechselnden Ansichten lassen sich viele Informationen auf einem Bildschirm unterbringen. Automatische Rückkehr zur Startseite nach einer festen Zeit hält das Tablet aufgeräumt.
• Dunkel und hell: Wenn das Tablet nachts im Raum hängt, kann eine automatische Helligkeits- oder Dunkelmodus-Steuerung blenden vermeiden.

Häufige Probleme

• Layout weicht vom PC ab: Auf dem Tablet testen und das Dashboard im verkleinerten Browserfenster prüfen.
• Karte wird nicht angezeigt (rotes Fehlerfeld): Entity-ID prüfen, die Custom Card installiert und als Ressource geladen? Browser-Cache leeren.
• Nach dem Update sieht alles anders aus: Release Notes lesen, Custom Cards aktualisieren, ggf. Backup einspielen.
• Entity umbenannt: Alte Verweise in allen Dashboards ersetzen. Prüfe dabei auch Nebendashboards.

Frage im Forum

Wenn du Hilfe zu deinem Dashboard brauchst, schreib hier ein neues Thema und nenne bitte:

• Home-Assistant-Version und das verwendete Layout (Masonry, Sections, Panel)
• die YAML der betroffenen Karte oder Ansicht
• ein Screenshot und die Fehlermeldung aus der Browser-Konsole, falls vorhanden
• ob es am Tablet, Smartphone oder PC auftritt

Tokens, Passwörter und private Adressen bitte vorher entfernen.

Der Aufbau: Trigger, Bedingung, Aktion

Jede Automation besteht aus drei Teilen:

• Auslöser (Trigger): Wann soll die Automation starten? Zum Beispiel bei einer Zustandsänderung, zu einer Uhrzeit, bei Sonnenuntergang oder wenn ein Wert eine Schwelle überschreitet.
• Bedingung (Condition): Unter welchen Umständen darf sie laufen? Zum Beispiel nur abends, nur wenn jemand zu Hause ist oder nur wenn ein bestimmter Schalter aktiv ist. Bedingungen sind optional, aber sehr nützlich, um unerwünschte Auslösungen zu vermeiden.
• Aktion (Action): Was soll passieren? Licht schalten, eine Benachrichtigung senden, ein Skript starten oder eine Szene aktivieren.

Hinweis zu älteren Anleitungen: Früher hieß es „service“ und „platform“. In der aktuellen Dokumentation heißen die Bausteine triggers, conditions und actions, und statt „call a service“ spricht man von einer Aktion. Beim Nachbauen alter Anleitungen lohnt sich ein Blick in die aktuelle Doku.

Ein einfaches Beispiel in YAML

Licht im Wohnzimmer 30 Minuten vor Sonnenuntergang einschalten:

alias: Wohnzimmerlicht vor Sonnenuntergang
triggers:
  - trigger: sun
    event: sunset
    offset: "-00:30:00"
actions:
  - action: light.turn_on
    target:
      entity_id: light.wohnzimmer

Die Entity-ID light.wohnzimmer ersetzt du durch deine eigene. Die Automation legst du unter Einstellungen > Automationen & Szenen an. Dort kannst du oben rechts im Menü zwischen dem grafischen Editor und In YAML bearbeiten wechseln.

Die vier Modi: Was passiert bei erneutem Auslösen?

Wenn eine Automation noch läuft und erneut ausgelöst wird, entscheidet der Modus über das Verhalten:

• single (Standard): Der neue Start wird ignoriert, es erscheint eine Warnung im Log.
• restart: Der laufende Durchlauf wird abgebrochen und neu gestartet. Ideal für Bewegungsmelder mit Wartezeit („Licht 2 Minuten nach der letzten Bewegung ausschalten“).
• queued: Neue Starts warten, bis die vorherigen fertig sind, in der Reihenfolge ihres Eintreffens.
• parallel: Jeder Start läuft unabhängig und gleichzeitig.

Den Modus änderst du im grafischen Editor über das Drei-Punkte-Menü oder in YAML mit der Zeile mode: restart. Bei queued und parallel lässt sich mit max die Zahl der gleichzeitigen oder wartenden Durchläufe begrenzen.

Skripte, Szenen und Blueprints

• Skripte sind wiederverwendbare Aktionsfolgen. Du kannst sie aus Automationen aufrufen oder manuell starten, zum Beispiel „Gute Nacht“ mit mehreren Schritten.
• Szenen speichern einen Zustand mehrerer Geräte (zum Beispiel „Filmabend“) und stellen ihn per Knopfdruck wieder her.
• Blueprints sind Vorlagen für Automationen. Du importierst eine fertige Vorlage und trägst nur noch deine Geräte ein.

Templates: dynamische Werte

Mit Templates (Jinja2) lassen sich Werte dynamisch berechnen, zum Beispiel eine Benachrichtigung mit der aktuellen Temperatur. Testen kannst du sie unter Entwicklerwerkzeuge > Vorlage, bevor du sie in einer Automation verwendest.

Typische Fehler und Tipps

• Zu viele Auslöser ohne Bedingung: Prüfe, ob die Automation ungewollt mehrfach läuft. Mit Bedingungen engst du den Einsatz ein.
• Falscher Modus: Wenn Wartezeiten ignoriert werden oder die Automation nicht erneut startet, hilft oft ein Wechsel von single zu restart.
• Entity wurde umbenannt: Nach dem Umbenennen von Geräten müssen alte Verweise in Automationen, Skripten, Szenen und Dashboards angepasst werden. Suche vorher nach allen Stellen, an denen die Entity vorkommt.
• Fehlersuche: In der Automation findest du den Verlauf (Traces). Dort siehst du, welcher Schritt ausgeführt wurde und wo es hakt.
• Backup: Vor größeren Umbauten ein Backup anlegen.

Frage im Forum

Wenn deine Automation nicht wie erwartet läuft, schreib hier ein neues Thema und nenne bitte:

• deine Home-Assistant-Version
• die Automation als YAML (im Editor über „In YAML bearbeiten“ kopieren)
• was du erwartest und was tatsächlich passiert
• den Trace oder Logeinträge als Text

Passwörter, Tokens und persönliche Daten bitte vorher entfernen.

Die drei Wege im Überblick

• Assist (lokal): Der Sprachassistent von Home Assistant. Spracherkennung, Sprachausgabe und Wake-Word können komplett auf deiner eigenen Hardware laufen. Es funktioniert auch ohne Internet, und deine Sprache verlässt das Haus nicht.
• Alexa: Du steuerst deine Geräte über Amazon-Lautsprecher und die Alexa-App. Die Sprachverarbeitung läuft in der Cloud von Amazon.
• Google Assistant: Dasselbe Prinzip mit Google-Lautsprechern und der Google-Home-App.

Alexa und Google sind bequem, weil du vorhandene Lautsprecher nutzen kannst. Assist ist dafür unabhängig von der Cloud, braucht aber etwas mehr Einrichtung.

Assist lokal einrichten

Assist besteht aus mehreren Bausteinen, die in einer Pipeline zusammengefasst werden:

1. Spracherkennung (STT): wandelt Sprache in Text um. Lokal möglich mit Whisper oder Speech-to-Phrase. Speech-to-Phrase erkennt nur bekannte Satzmuster, ist dafür schnell und braucht wenig Rechenleistung.
2. Sprachausgabe (TTS): macht aus Text wieder Sprache, lokal zum Beispiel mit Piper.
3. Konversationsagent: verarbeitet den Befehl. Der Standard-Agent von Home Assistant versteht feste Satzmuster und arbeitet lokal.
4. Wake-Word: das Aktivierungswort, zum Beispiel über openWakeWord.

Diese Dienste werden über das Wyoming-Protokoll angebunden und lassen sich als Apps (früher Add-ons) installieren. Danach legst du unter Einstellungen > Sprachassistenten eine Pipeline an und wählst die Bausteine aus.

Voice-Satelliten: Sprechen in jedem Raum

Damit du in mehreren Räumen mit Home Assistant sprechen kannst, brauchst du Satelliten, also Geräte mit Mikrofon und Lautsprecher. Sie lauschen auf das Wake-Word und schicken danach die Sprache an Home Assistant. Möglichkeiten sind spezielle Hardware (zum Beispiel Home Assistant Voice Preview Edition), ESP32-Eigenbauten oder auch ein altes Tablet oder Smartphone mit einer passenden App.

Alexa und Google Assistant anbinden

Es gibt zwei Wege:

• Mit Home Assistant Cloud (Nabu Casa): Die einfachste Variante, die Freigabe erfolgt über die Einstellungen.
• Manuell per YAML: Du richtest die Anbindung selbst ein, mit eigenem Skill bei Alexa beziehungsweise eigenem Projekt bei Google. Das braucht mehr Aufwand und eine von außen erreichbare, gesicherte Adresse (HTTPS), dafür ohne Abo.

In beiden Fällen entscheidest du, welche Entities freigegeben werden. Gib nur an, was du wirklich per Sprache steuern willst.

Sicherheit: Was du nicht freigeben solltest

• Türschlösser, Garagentore, Alarmanlagen und Geräte, die unbeaufsichtigt Schaden anrichten könnten (zum Beispiel Wäschetrockner oder Heizgeräte), besser nicht per Sprache schaltbar machen. Falls doch, nur mit Bestätigung oder PIN.
• Duplikate vermeiden: Wenn eine Lampe sowohl lokal als auch über die Cloud eingebunden ist, gib nur eine Variante frei, sonst erscheint sie doppelt.
• Gib den Entities eindeutige Namen und Räume, dann versteht die Sprachsteuerung bessere Befehle.

Eigene Sätze und Aliase

Assist versteht feste Satzmuster. Du kannst sie erweitern:

• Aliase für Entities vergeben (zum Beispiel „Couchlicht“ für die Lampe im Wohnzimmer).
• Eigene Sätze (Custom Sentences) in der Konfiguration hinterlegen, damit auch Formulierungen wie „mach Vitrine an“ erkannt werden.

Teste neue Sätze unter Einstellungen > Sprachassistenten im Eingabefeld, bevor du sie ausprobierst.

Häufige Probleme

• Befehl wird nicht erkannt: Satz im Textfeld testen, Entity-Name und Alias prüfen, ob die Entity für Assist freigegeben ist.
• Antwort ist zu allgemein: Die gesprochene Rückmeldung nennt oft nur „Licht an“, statt den Gerätenamen. Das lässt sich über eigene Antworten anpassen.
• Wake-Word reagiert zu oft oder zu selten: Empfindlichkeit anpassen und die Position des Satelliten prüfen.
• Kein Ton: Prüfen, ob in der Pipeline eine Sprachausgabe gewählt ist. Manche Satelliten funktionieren ohne Sprachausgabe nicht.
• Alexa findet Geräte doppelt oder nicht: Nach Änderungen der Freigabe die Geräteerkennung in der Alexa-App neu starten.

Frage im Forum

Wenn du nicht weiterkommst, schreib hier ein neues Thema und nenne bitte:

• Home-Assistant-Version und welche Pipeline du nutzt (STT, TTS, Agent, Wake-Word)
• Satelliten-Hardware oder Lautsprecher (Alexa, Google, andere)
• den genauen Satz, den du gesprochen hast, und die Antwort
• relevante Logeinträge als Text

Zugangsdaten, Tokens und Schlüssel bitte vorher entfernen.

Was ist was?

• Zigbee ist ein Funkstandard für Lampen, Sensoren, Thermostate und Schalter. Die Geräte bilden ein stromsparendes Mesh-Netz, bei dem sich Geräte gegenseitig als Router nutzen.
• Thread ist ebenfalls ein stromsparendes Mesh-Netz, das auf IP basiert. Es dient als Transportweg für Matter-Geräte.
• Matter ist ein herstellerübergreifender Standard für Smart-Home-Geräte. Matter-Geräte laufen entweder über WLAN oder über Thread. Für Thread brauchst du einen sogenannten Thread Border Router, der das Thread-Netz mit deinem Heimnetz verbindet.

Kurz gesagt: Zigbee ist ein eigenes System, Matter ist der Standard, und Thread ist einer der Wege, auf denen Matter-Geräte funken.

Was brauchst du für Zigbee?

Du brauchst einen Zigbee-Koordinator, also einen USB-Stick oder ein Netzwerkgerät, das dein Zigbee-Netz aufbaut. Beliebte Modelle sind zum Beispiel der SONOFF Zigbee 3.0 Dongle Plus (MG24) oder der Home Assistant Connect ZBT-2. Beachte die Hinweise zu Chipsatz und Firmware in der Dokumentation von Zigbee2MQTT oder ZHA, bevor du kaufst.

Wichtig bei USB-Sticks: Betreibe ihn nicht direkt neben dem USB-3.0-Anschluss, SSD oder Mini-PC. Nutze ein USB-Verlängerungskabel, denn Störungen sind eine häufige Ursache für Verbindungsabbrüche.

ZHA oder Zigbee2MQTT?

Home Assistant bietet zwei Wege für Zigbee:

• ZHA ist direkt in Home Assistant eingebaut. Die Einrichtung ist einfach, du brauchst nur Home Assistant und den Koordinator.
• Zigbee2MQTT läuft als eigener Dienst und kommuniziert über einen MQTT-Broker (zum Beispiel Mosquitto) mit Home Assistant. Die Einrichtung hat mehr Schritte, dafür bekommst du mehr Einstellmöglichkeiten und läuft unabhängig von Home Assistant.

Beide sind ausgereift. Für einen schnellen Start ist ZHA oft die einfachere Wahl, Zigbee2MQTT lohnt sich, wenn du Geräte detailliert konfigurieren möchtest. Es gilt: Pro Koordinator nur eine der beiden Lösungen. Wenn du beide parallel nutzen willst, braucht jede einen eigenen Koordinator.

Was brauchst du für Matter und Thread?

• In Home Assistant die Matter-Integration (der Matter-Server wird dafür mitinstalliert).
• Für Thread-Geräte einen Thread Border Router. Home Assistant kann nur einen OpenThread Border Router selbst konfigurieren. Das geht mit Geräten wie dem Home Assistant Connect ZBT-2 oder anderen Sticks, die mit Thread-Firmware laufen. Auch Apple TV oder HomePod können als Border Router dienen, aber die Zugangsdaten müssen über die Companion-App auf dein Handy geholt werden.
• Faustregel: Ein Funkchip betreibt ein Protokoll. Ein einzelner Stick läuft je nach geflashter Firmware entweder für Zigbee oder für Thread. Willst du beides, brauchst du zwei Sticks oder ein Gerät mit zwei Funkmodulen.

Tipps für ein stabiles Netz

• Router-Geräte einplanen: Netzbetriebene Zigbee-Geräte (Steckdosen, Lampen) verstärken das Mesh. Batteriegeräte leiten keine Daten weiter.
• Kanalwahl: Zigbee und WLAN teilen sich das 2,4-GHz-Band. Stelle Zigbee und WLAN auf Kanäle, die sich nicht überlappen. Wenn du Thread zusätzlich nutzt, wähle auch hier einen eigenen Kanal.
• Koordinator zentral platzieren und mit Verlängerungskabel vom Server wegrücken.
• Geräte nah am Koordinator anlernen, dann an ihren Platz bringen.
• Backup der Zigbee-Daten (Koordinator-Backup) vor Updates oder einem Hardwarewechsel anlegen.
• Thermostate und Sensoren: Prüfe nach dem Anlernen im Log, ob alle Werte plausibel ankommen.

Typische Probleme

• Geräte werden „nicht verfügbar“: meist zu schwaches Mesh oder Störungen. Router-Geräte ergänzen, Stick verlängern.
• Gerät lässt sich nicht anlernen: Pairing-Modus am Gerät und in der Integration prüfen, näher an den Koordinator gehen.
• Matter-Gerät wird nicht gefunden: Prüfen, ob dein Handy dasselbe Thread-Netz kennt wie Home Assistant.
• Nach einem Update funktioniert etwas nicht mehr: Release Notes lesen und Backup zurückspielen.

Frage im Forum

Wenn du nicht weiterkommst, schreib hier ein neues Thema und nenne bitte:

• Home-Assistant-Version und Installationsart
• Koordinator (Modell, Firmware) und ob du ZHA oder Zigbee2MQTT nutzt
• das betroffene Gerät (Hersteller, Modell)
• Logeinträge als Text

Netzwerkschlüssel und IEEE-Adressen sind unkritisch, Passwörter und Tokens bitte vorher entfernen.

Cloud oder lokal: Was ist der Unterschied?

Die offizielle Tuya-Integration in Home Assistant steuert deine Geräte über die Server von Tuya. Das ist einfach einzurichten, aber du bist vom Internet und vom Dienst abhängig, und Befehle brauchen oft etwas länger.

LocalTuya spricht dagegen direkt mit dem Gerät im lokalen Netzwerk. Das ist schneller und funktioniert auch bei Internetausfall. Die Cloud wird laut Projektbeschreibung nur beim Start und bei einem nötigen Update des local_key angefragt.

Beide Integrationen können parallel laufen. Das ist praktisch, denn so hast du die Cloud-Variante als Rückfall, falls ein Gerät lokal mal nicht erreichbar ist.

Was brauchst du?

• Home Assistant mit installiertem HACS (der Community-Store für Zusatzintegrationen)
• Die Geräte sind in der Smart-Life- oder Tuya-App eingerichtet und funktionieren dort
• Ein kostenloses Konto auf der Tuya IoT Platform (iot.tuya.com) mit einem Cloud-Projekt, um die Zugangsdaten und die Geräteschlüssel abzufragen
• Die Geräte im selben Netzwerk wie Home Assistant

Welche LocalTuya-Version?

Das ursprüngliche LocalTuya-Projekt wird kaum noch weiterentwickelt. Neuere Geräte nutzen teils das Protokoll 3.5, und das beherrscht die ursprüngliche Version nicht. Viele nutzen deshalb den Fork von xZetsubou (Repository: github.com/xZetsubou/hass-localtuya), der Protokoll 3.5 unterstützt. Installation über HACS: Menü oben rechts, Benutzerdefinierte Repositories, Adresse eintragen, Kategorie Integration wählen und installieren. Danach Home Assistant neu starten.

Einrichtung in Kurzform

1. LocalTuya unter Einstellungen > Geräte & Dienste > Integration hinzufügen hinzufügen.
2. Die Zugangsdaten deines Tuya-IoT-Projekts (Client ID und Secret) eintragen.
3. Die Geräte werden anschließend aufgelistet. Pro Gerät brauchst du die Geräte-ID, die IP-Adresse und den local_key.
4. Protokollversion wählen (3.3, 3.4 oder 3.5) und die Entities (Schalter, Licht, Sensor) zuordnen.
5. Geräte einen aussagekräftigen Namen geben, bevor du sie in Automationen oder bei Alexa verwendest.

Häufige Fehler

• Falscher Schlüssel: Der „Secret“ des Cloud-Projekts ist nicht der local_key. Das ist einer der häufigsten Fehler. Der local_key gehört zum einzelnen Gerät.
• local_key ändert sich: Wenn du ein Gerät neu koppelst (zum Beispiel nach einem Reset), bekommt es einen neuen Schlüssel. Dann muss der Eintrag in LocalTuya aktualisiert werden.
• Falsche Protokollversion: Eine falsche Version und ein falscher Schlüssel sehen im Fehlerbild ähnlich aus. Probiere bei Verbindungsfehlern zuerst die anderen Versionen durch.
• IP-Adresse ändert sich: Vergib den Geräten in deinem Router feste IP-Adressen (DHCP-Reservierung). Sonst findet LocalTuya sie nach einer Weile nicht mehr.
• Eine Verbindung gleichzeitig: Viele Tuya-Geräte nehmen nur wenige lokale Verbindungen an. Wenn ein anderes Programm (z. B. ein Test-Tool) gerade verbunden ist, kann es zu Verbindungsabbrüchen kommen.
• Updates: Nach größeren Home-Assistant-Updates kurz prüfen, ob die Geräte noch erreichbar sind und im Log keine Fehler von LocalTuya stehen.

Gibt es eine Alternative?

Ja: Tuya Local (github.com/make-all/tuya-local) ist eine weitere HACS-Integration, die Geräte anhand vorgefertigter Profile einrichtet. Das spart Arbeit bei der Zuordnung der Datenpunkte, wenn dein Gerät dort bereits unterstützt wird. Welche Lösung besser passt, hängt vom Gerät ab.

Tipps für den Alltag

• Lege Cloud-Entities und lokale Entities nicht durcheinander: Benenne beide klar (zum Beispiel „Vitrine“ und „Vitrine Cloud“).
• Wenn du Alexa oder Google Assistant nutzt, gib vor der Geräteerkennung nur die lokalen Entities frei.
• Mach vor größeren Umstellungen ein Backup.

Frage im Forum

Wenn bei dir etwas nicht klappt, schreib hier ein neues Thema und nenne bitte:

• die Home-Assistant-Version und die LocalTuya-Version (Original oder Fork)
• den Gerätetyp und die Protokollversion
• die Fehlermeldung aus dem Log (bitte als Text)

Schlüssel, Secrets und Zugangsdaten bitte vor dem Posten entfernen.

Welche Installationsarten gibt es?

Offiziell unterstützt werden nur noch zwei Varianten: Home Assistant OS und Home Assistant Container. Die Methoden „Core“ und „Supervised“ wurden Mitte 2025 als veraltet erklärt, der Support dafür lief mit Version 2025.12 aus. Wenn du neu startest, wähle also eine der beiden unterstützten Varianten.

Home Assistant OS (empfohlen für Einsteiger)
Ein fertiges, schlankes Betriebssystem, das nur für Home Assistant gedacht ist. Updates, Backups und Add-ons (z. B. Zigbee2MQTT, Grafana, MariaDB) lassen sich bequem über die Oberfläche verwalten. Das ist der Weg, der für die meisten am besten funktioniert.

Home Assistant Container
Home Assistant läuft als Docker-Container auf einem Linux-System, das du selbst betreust. Du bekommst keine Add-ons, sondern installierst Zusatzdienste wie MQTT-Broker oder Zigbee2MQTT selbst als eigene Container. Das ist sinnvoll, wenn du schon einen Server mit Docker betreibst und die volle Kontrolle willst.

Auf welcher Hardware läuft Home Assistant?

• Raspberry Pi: Beliebter Einstieg, stromsparend und günstig. Nimm eine hochwertige SD-Karte oder, besser, eine SSD.
• Mini-PC (z. B. mit Intel N100): Mehr Leistung, gut für größere Installationen mit vielen Geräten, Datenbank und Add-ons.
• Virtuelle Maschine (Proxmox, VMware, VirtualBox, KVM): Ideal, wenn du schon einen Server oder ein Homelab hast. Snapshots und Backups sind hier besonders einfach.
• Fertiggeräte: Home Assistant bietet eigene Geräte an, die ohne Bastelei starten.

Wichtig bei jeder Hardware: Eine SSD ist langlebiger als eine SD-Karte, weil Home Assistant ständig Daten in die Datenbank schreibt.

Erste Schritte nach der Installation

1. Konto anlegen und Standort, Zeitzone und Einheiten einstellen.
2. Automatisch erkannte Geräte unter Einstellungen > Geräte & Dienste hinzufügen.
3. Backup einrichten, bevor du viel konfigurierst. Speichere Sicherungen nicht nur auf dem Gerät selbst, sondern auch auf einem anderen System.
4. Zugriff von außen erst später und gut abgesichert einrichten (z. B. über einen Reverse Proxy mit HTTPS). Öffne niemals einfach Ports ohne Schutz.
5. Mit einer ersten einfachen Automation starten, zum Beispiel Licht bei Sonnenuntergang.

Updates ohne Ärger

Home Assistant erscheint jeden Monat in einer neuen Version. Lies vor dem Update die Release Notes, vor allem den Abschnitt „Breaking Changes“. Mach vorher immer ein Backup oder, bei einer VM, einen Snapshot. Dann lässt sich im Notfall in Minuten zurückspringen.

Häufige Einsteigerfragen

Brauche ich eine Cloud oder ein Abo?
Nein. Home Assistant läuft komplett lokal und kostenlos. Ein optionaler Cloud-Dienst ist nur für den einfachen Fernzugriff gedacht.

Kann ich meine bestehenden Geräte weiter nutzen?
In den meisten Fällen ja. Es gibt Tausende Integrationen, darunter Zigbee, Matter, Thread, Tuya, Philips Hue, Shelly, Sonos und viele mehr.

Wie gehe ich bei Problemen vor?
Schau zuerst ins Log unter Einstellungen > System > Protokolle. Die Fehlermeldungist meistens der beste Hinweis.

Hilfe im Forum bekommen

Wenn du Fragen hast, schreib einen neuen Beitrag in diesem Bereich. Damit dir schnell geholfen werden kann, nenne bitte:

• deine Home-Assistant-Version und die Installationsart (OS, Container, VM, Hardware)
• eine genaue Beschreibung des Problems und was du schon probiert hast
• relevante Logeinträge (bitte als Text, nicht als Foto)

Passwörter, Tokens und API-Schlüssel bitte vorher aus Logs und Konfigurationen entfernen.

Viel Spaß beim Start in dein eigenes Smart Home!

ich spiele schon länger mit dem Gedanken, mir einen Schnoodle zuzulegen, also einen Mix aus Schnauzer und Pudel. Mir gefällt die Mischung aus Intelligenz, Aktivität und dem oft eher allergikerfreundlichen Fell. Trotzdem habe ich das Gefühl, dass es bei Designer‑Mixen große Unterschiede geben kann – sowohl beim Aussehen als auch beim Charakter.

Darum würde ich gerne eure Erfahrungen hören. Ich habe da auch auf diesen Portal einen ganz süßen Hund gefunden Schnoodle kaufen