UniFi Switch in Home Assistant integrieren
Einleitung
Die Integration von UniFi Switches in Home Assistant (HA) ermöglicht eine zentrale Steuerung und Überwachung von Netzwerkgeräten in einem Smart-Home-Setup. Diese Integration ist besonders relevant für Benutzer, die PoE (Power over Ethernet) Switches verwenden, um ihre IP-Kameras und andere Geräte zu betreiben. Eine fehlerhafte Konfiguration kann jedoch zu Verbindungsproblemen führen.
Problem
Ein Benutzer hat Schwierigkeiten, einen UniFi PoE Switch (USW Flex) in Home Assistant zu integrieren, nachdem er einen UniFi Network Controller auf einem Raspberry Pi 4 installiert hat. Trotz der Erstellung eines Admin-Kontos für den Zugriff auf Home Assistant schlägt die Verbindung fehl. Der Benutzer vermutet, dass es sich um ein Problem mit den Zugriffsberechtigungen handelt, da die Benutzeroberfläche des UniFi Controllers von den in älteren Anleitungen beschriebenen abweicht.
Lösung
Um den UniFi Switch erfolgreich in Home Assistant zu integrieren, ist es wichtig, den richtigen Port des UniFi Controllers zu verwenden. Standardmäßig wird der UniFi Controller über Port 8443 angesprochen. Wenn dieser Port nicht korrekt konfiguriert ist, kann dies zu Verbindungsproblemen führen.
Schritte zur Umsetzung
1. Zugriff auf den UniFi Controller: Öffne die Weboberfläche des UniFi Controllers in deinem Browser.
2. Port überprüfen: Überprüfe, welcher Port für die Verbindung verwendet wird. Standardmäßig ist dies Port 8443. Notiere dir diesen Port.
3. Integration in Home Assistant konfigurieren: Gehe in die Konfiguration von Home Assistant und füge die UniFi Integration hinzu. Stelle sicher, dass du die IP-Adresse des Controllers und den korrekten Port (z.B. 8443) eingibst.
Beispielkonfiguration in configuration.yaml:
unifi:
controllers:
- host: <IP-Adresse des Controllers>
port: 8443
username: <dein Admin-Benutzername>
password: <dein Passwort>
- Home Assistant neu starten: Starte Home Assistant neu, um die Änderungen zu übernehmen.
- Überprüfung der Verbindung: Überprüfe in der Benutzeroberfläche von Home Assistant, ob der UniFi Switch erfolgreich integriert wurde.
Hintergrundwissen
Die Integration von UniFi Geräten in Home Assistant erfordert die korrekte Konfiguration der Benutzerrechte und Ports. Der UniFi Controller verwendet standardmäßig Port 8443 für HTTPS-Verbindungen. Wenn dieser Port nicht korrekt angegeben wird, kann Home Assistant keine Verbindung zum Controller herstellen. Zudem ist es wichtig, sicherzustellen, dass der Benutzer, der für die Integration verwendet wird, über die notwendigen Berechtigungen verfügt.
Zusätzliche Infos
| Funktion | Erklärung |
|---|---|
| `host` | IP-Adresse des UniFi Controllers. |
| `port` | Port, über den der Controller angesprochen wird (Standard: 8443). |
| `username` | Benutzername für den Zugriff auf den UniFi Controller. |
| `password` | Passwort für den Zugriff auf den UniFi Controller. |
Hinweise & Best Practices
- Stelle sicher, dass der UniFi Controller und Home Assistant im selben Netzwerk sind, um Verbindungsprobleme zu vermeiden.
- Überprüfe die Firewall-Einstellungen, um sicherzustellen, dass der Port 8443 nicht blockiert ist.
- Halte die Software des UniFi Controllers und von Home Assistant auf dem neuesten Stand, um von Verbesserungen und Fehlerbehebungen zu profitieren.
- Dokumentiere alle Änderungen in der Konfiguration, um bei zukünftigen Problemen schnell darauf zurückgreifen zu können.
