Wenn eine Home-Assistant-Box keine Netzwerkverbindung zum Switch bekommt, sollte die Fehlersuche nicht sofort bei Home Assistant selbst beginnen. Der schnellste Weg ist, die Verbindung Schicht für Schicht zu prüfen: Strom, Ethernet-Link, Kabel, Switch-Port, DHCP, VLAN und erst danach die Home-Assistant-Konfiguration.
1. Link-LEDs am Ethernet-Port prüfen
Der wichtigste erste Hinweis ist die physische Verbindung. Schau auf die LEDs am Netzwerkanschluss der Home-Assistant-Box und am verwendeten Switch-Port.
- Keine LED: Es gibt wahrscheinlich keinen physischen Link. Kabel, Switch-Port, Stromversorgung oder Netzwerkadapter prüfen.
- LED leuchtet oder blinkt: Die physische Ethernet-Verbindung steht grundsätzlich; dann geht es mit IP und Netzwerk-Konfiguration weiter.
Ohne Link-LED lohnt es sich nicht, zuerst DNS oder Home-Assistant-Einstellungen zu untersuchen.
2. Ethernet-Kabel tauschen
Ein defektes oder schlecht sitzendes Kabel ist banal, aber häufig. Teste ein zweites bekannt funktionierendes Netzwerkkabel.
Besonders bei selbst gecrimpten Kabeln, Wanddosen oder Patchfeldern sollte zusätzlich eine direkte kurze Verbindung zum Switch beziehungsweise Router getestet werden.
3. Anderen Switch-Port verwenden
Stecke die Box testweise an einen anderen Port. Wenn dort sofort ein Link entsteht, liegt das Problem wahrscheinlich am ursprünglichen Port oder dessen Konfiguration.
Bei Managed Switches kann ein Port administrativ deaktiviert, einem falschen VLAN zugeordnet oder durch eine Sicherheitsfunktion blockiert sein.
4. Direkt am Router testen
Der beste Gegentest für einen verdächtigen Switch ist eine direkte Verbindung zum Router.
Funktioniert Home Assistant am Router sofort, aber nicht am Switch, liegt der Fehler sehr wahrscheinlich zwischen Switch-Konfiguration und Verkabelung – nicht am Home-Assistant-System selbst.
5. Bekommt die Box eine IP-Adresse?
Wenn die Link-LEDs aktiv sind, sollte der DHCP-Server des Routers eine IP-Adresse vergeben. Öffne die Geräteliste des Routers und suche nach:
- einem Gerät namens
homeassistant, - einer neuen MAC-Adresse,
- einem unbekannten kabelgebundenen Gerät.
Notiere die IP-Adresse und rufe Home Assistant direkt über http://IP-ADRESSE:8123 auf.
6. homeassistant.local funktioniert nicht
Die Adresse homeassistant.local nutzt lokale Namensauflösung. Wenn sie nicht funktioniert, heißt das nicht automatisch, dass Home Assistant offline ist.
Teste immer zusätzlich die direkte IP-Adresse. Funktioniert diese, liegt das Problem eher bei mDNS oder der Namensauflösung.
7. DHCP-Probleme
Wenn die Box einen Link hat, aber keine IP bekommt, prüfe den DHCP-Server. Häufige Ursachen:
- DHCP ist im betreffenden VLAN nicht aktiv.
- Adresspool ist ausgeschöpft.
- falsche statische Netzwerkeinstellung auf Home Assistant.
- MAC-basierte Zugriffskontrolle blockiert das Gerät.
8. Statische IP kann zum Problem werden
Wurde Home Assistant irgendwann mit einer statischen IP konfiguriert, kann diese nach Router- oder Netzumbau nicht mehr zum aktuellen Subnetz passen.
Beispiel: Das Heimnetz wurde von 192.168.1.x auf 192.168.178.x geändert. Eine alte statische Adresse macht das Gerät dann scheinbar unsichtbar.
9. Managed Switch: VLAN prüfen
Bei UniFi, TP-Link Omada, MikroTik und ähnlichen Managed Switches ist die VLAN-Konfiguration eine häufige Ursache. Prüfe:
- welchem VLAN der Port zugeordnet ist,
- ob dieses VLAN einen DHCP-Server erreicht,
- ob der Port als Access-/Untagged-Port korrekt konfiguriert ist,
- ob Firewall-Regeln den Zugriff auf Port 8123 verhindern.
10. Native VLAN und Tagged VLANs nicht verwechseln
Eine Home-Assistant-Box sendet am normalen Ethernet-Port nicht automatisch die VLAN-Tags, die dein Switch vielleicht erwartet. Wenn der Port ausschließlich tagged Traffic verlangt, bekommt das Gerät unter Umständen keine nutzbare Verbindung.
Für einen einfachen Test den Port vorübergehend wie einen normalen untagged LAN-Port konfigurieren.
11. Spanning Tree und Port-Sicherheitsfunktionen
STP kann einen Port beim Link-Aufbau kurz blockieren. Das ist normalerweise nur vorübergehend. Bleibt der Port dauerhaft blockiert, sollte die Switch-Konfiguration geprüft werden.
Auch Funktionen wie Port Security, MAC-Limits oder 802.1X können ein neues Gerät am Port verhindern.
12. PoE ist bei Home Assistant Green nicht die normale Versorgung
Home Assistant Green wird über sein vorgesehenes Netzteil versorgt. Ein Ethernet-Kabel ersetzt diese Stromversorgung nicht einfach. Prüfe daher, ob das Gerät stabil mit Strom versorgt wird.
Bei Raspberry-Pi-basierten Installationen kann ein zu schwaches Netzteil ebenfalls zu instabilem Netzwerkverhalten führen.
13. Router zeigt eine IP, aber Weboberfläche nicht erreichbar
Dann prüfen:
- Ist Port 8123 erreichbar?
- Ist der Client im gleichen Subnetz oder darf das VLAN auf Home Assistant zugreifen?
- Wurde eine Firewall-Regel geändert?
- Startet Home Assistant noch?
Ein Ping allein reicht nicht immer, aber die Kombination aus DHCP-Lease und Port-8123-Test grenzt das Problem ein.
14. Home Assistant startet noch?
Wenn Netzwerk-Link und IP plausibel sind, aber die Oberfläche nicht erscheint, kann Home Assistant selbst noch booten oder hängen.
Nach einem Update oder Stromausfall kann der Start länger dauern. Gib dem System einige Minuten und prüfe erneut.
15. Lokale Konsole als Diagnose
Bei unterstützter Home-Assistant-Hardware beziehungsweise Home Assistant OS kann eine lokale Konsole bei der Diagnose helfen. Je nach Gerät erfolgt der Zugang über den vorgesehenen Display-/Konsolenanschluss und eine Tastatur beziehungsweise serielle Konsole.
Dort lässt sich prüfen, ob das System gebootet hat und welche Netzwerkinformationen vorhanden sind. Die genaue Anschlussmethode hängt vom Gerät ab und sollte der offiziellen Hardware-Dokumentation folgen.
16. IP-Scanner nur als Hilfsmittel
Programme wie Fing oder ein IP-Scanner können unbekannte Adressen finden. Sie ersetzen aber nicht die Router- und Switch-Diagnose. Wenn ein VLAN isoliert ist, kann ein Scanner aus einem anderen Netz das Gerät möglicherweise gar nicht sehen.
17. Firewall zwischen VLANs
Wenn Home Assistant bewusst in einem IoT-VLAN steht, muss dein PC oder Smartphone die Weboberfläche trotzdem erreichen dürfen. Dafür braucht es eine entsprechende Firewall-Regel.
Ein Gerät kann also korrekt online sein und trotzdem aus deinem Verwaltungsnetz nicht erreichbar wirken.
18. DNS und mDNS getrennt betrachten
homeassistant.local basiert auf lokaler Namensauflösung und ist nicht dasselbe wie ein normaler DNS-Eintrag. Wenn die IP-Adresse funktioniert, sollte nicht am Ethernet-Kabel weitergesucht werden.
19. Nach Switch-Neustart funktioniert es
Dann sollte geprüft werden, ob der Port vorher in einem fehlerhaften Zustand hing oder eine dynamische Sicherheits-/VLAN-Konfiguration beteiligt war. Ein Neustart ist nützlich als Test, aber keine dauerhafte Fehleranalyse.
20. Sinnvolle Diagnose-Reihenfolge
- Stromversorgung prüfen.
- Link-LEDs prüfen.
- anderes Kabel testen.
- anderen Switch-Port testen.
- direkt am Router testen.
- DHCP-Lease beziehungsweise IP-Adresse suchen.
- IP:8123 direkt aufrufen.
- bei Managed Switch VLAN und Portprofil prüfen.
- Firewall zwischen Netzen prüfen.
- erst danach lokale Home-Assistant-Konfiguration untersuchen.
Fazit
Wenn Home Assistant keine Verbindung zum Switch bekommt, ist eine strukturierte Netzwerkdiagnose deutlich effizienter als wahlloses Neustarten. Keine Link-LED bedeutet: zuerst Kabel und Port. Link vorhanden, aber keine IP bedeutet: DHCP, VLAN oder statische Netzwerkeinstellung. IP vorhanden, aber Oberfläche nicht erreichbar bedeutet: Port 8123, Firewall oder Home-Assistant-Start prüfen. Mit dem direkten Routertest lässt sich der Switch als Fehlerquelle besonders schnell bestätigen oder ausschließen.