Wenn Sie Besitzer eines Smart-Home-Systems auf der Home Assistant-Plattform sind und Unterstützung für das Zigbee-Protokoll hinzufügen möchten, müssen Sie wahrscheinlich das zigbee2mqtt-Softwaremodul installieren. Diese Anleitung hilft Ihnen, zigbee2mqtt auf Ihrem Home Assistant zu installieren und für die Arbeit mit Zigbee-Geräten zu konfigurieren.
Stellen Sie zunächst sicher, dass Sie den Home Assistant auf der aktuellen Version installiert haben. Dann benötigen Sie einen Raspberry Pi mit dem Raspbian-Betriebssystem oder einem ähnlichen System.
Der erste Schritt besteht darin, die erforderlichen Pakete für die Arbeit mit zigbee2mqtt zu installieren. Öffnen Sie ein Terminal und führen Sie den folgenden Befehl aus:
sudo apt-get install git make g++ gcc
Nach der Installation der Pakete müssen Sie das zigbee2mqtt-Repository mit dem folgenden Befehl klonen:
git clone https://github.com/Koenkk/zigbee2mqtt.git
Nachdem Sie das Repository geklont haben, müssen Sie zum Projektordner navigieren, geben Sie den folgenden Befehl ein:
cd zigbee2mqtt
Jetzt müssen Sie alle Paketabhängigkeiten installieren, indem Sie den Befehl ausführen:
npm ci
Nachdem Sie die Abhängigkeiten installiert haben, müssen Sie die Konfigurationsdatei konfigurieren. Erstellen Sie es mit dem Befehl:
cp data/configuration.yaml.sample data/configuration.yaml
Öffnen Sie die Konfigurationsdatei und passen Sie sie an Ihre Bedürfnisse an.
Führen Sie nach dem Konfigurieren der Konfiguration zigbee2mqtt aus, und führen Sie den folgenden Befehl aus:
npm start
zigbee2mqtt sollte jetzt erfolgreich gestartet werden und bereit sein, mit Ihrem Smart Home zu verwenden!
Dies war eine detaillierte Anleitung zum Installieren und Konfigurieren von zigbee2mqtt im Home Assistant. Jetzt können Sie Zigbee-Geräte zu Ihrem Smart-Home-System hinzufügen und steuern. Viel Glück!
zigbee2mqtt in Home assistant 2025 installieren
Schritt 1: Vorbereitung
Stellen Sie vor der Installation sicher, dass Sie Home Assistant 2025 installiert haben und über einen USB-Adapter verfügen, der das Zigbee-Protokoll unterstützt.
Schritt 2: Installieren und Konfigurieren von Mosquitto
Bevor Sie zigbee2mqtt installieren, müssen Sie den MQTT Mosquitto Broker installieren und konfigurieren. Installieren Sie Mosquitto mit dem Befehl:
sudo apt-get install mosquitto mosquitto-clients
Nehmen Sie dann die erforderlichen Änderungen an der Mosquitto-Konfigurationsdatei vor:
sudo nano /etc/mosquitto/mosquitto.conf
Fügen Sie der Datei die folgenden Zeilen hinzu und speichern Sie sie:
persistence true persistence_location /var/lib/mosquitto/ log_dest file /var/log/mosquitto/mosquitto.log
Starten Sie anschließend den Mosquitto-Service mit dem Befehl neu:
sudo systemctl restart mosquitto
Hinweis: Sie können einen anderen MQTT-Broker als Mosquitto verwenden, wenn Sie möchten.
Schritt 3: Installieren von zigbee2mqtt
Jetzt können Sie zigbee2mqtt installieren. Führen Sie dazu die folgenden Befehle aus:
git clone https://github.com/Koenkk/zigbee2mqtt.git /opt/zigbee2mqtt cd /opt/zigbee2mqtt npm install
Schritt 4: Konfigurieren der Konfiguration
Jetzt müssen Sie die Konfigurationsdatei zigbee2mqtt konfigurieren.
Kopieren Sie die Beispielkonfigurationsdatei:
cp /opt/zigbee2mqtt/data/configuration.yaml.example /opt/zigbee2mqtt/data/configuration.yaml
Ändern Sie die Konfigurationseinstellungen in der Datei /opt/zigbee2mqtt/data/configuration.yaml entsprechend Ihrer Zigbee-Konfiguration.
Hinweis: Bitte beachten Sie, dass Sie die Adresse des MQTT-Brokers angeben müssen, den Sie in Schritt 2 eingerichtet haben.
Schritt 5: zigbee2mqtt ausführen
Jetzt können Sie zigbee2mqtt ausführen. Führen Sie dazu den folgenden Befehl aus:
Nachdem Sie zigbee2mqtt gestartet haben, können Sie alle Ihre Zigbee-Geräte über den Home Assistant sehen und verwalten.
Befolgen Sie diese einfachen Schritte und Sie haben zigbee2mqtt erfolgreich in Home Assistant 2025 installiert!
Vorbereiten der Installation von zigbee2mqtt in Home assistant
- Stellen Sie sicher, dass Sie den Home Assistant installiert haben. Wenn es noch keine gibt, können Sie es installieren, indem Sie die Anweisungen auf der offiziellen Home Assistant- Website befolgen.
- Stellen Sie sicher , dass Ihr Gerät zum Ausführen von Zigbee2mqtt über ausreichende Ressourcen verfügt. Daher ist es wichtig sicherzustellen, dass Ihr Gerät die Anforderungen erfüllt, da einige Geräte möglicherweise Einschränkungen hinsichtlich des Arbeitsspeichers oder der Netzwerkbandbreite aufweisen.
- Schließen Sie den Zigbee-Adapter an das Gerät an, auf dem Home Assistant installiert ist. Der Adapter kann über USB oder eine serielle Schnittstelle angeschlossen werden. Stellen Sie sicher, dass der Adapter an einen von Ihrem Gerät unterstützten Anschluss angeschlossen ist.
- Installieren Sie die erforderlichen Pakete, damit Zigbee2mqtt funktioniert. Öffnen Sie dazu ein Terminal oder eine Eingabeaufforderung und führen Sie den folgenden Befehl aus:
sudo apt-get install socat
git clone https://github.com/Koenkk/zigbee2mqtt.gitcd zigbee2mqttnpm install
Nachdem Sie diese Schritte ausgeführt haben, können Sie zigbee2mqtt im Home Assistant installieren und konfigurieren.
Installieren von zigbee2mqtt und seinen Abhängigkeiten in home assistant
Bevor Sie mit der Installation von zigbee2mqtt in home assistant beginnen, müssen Sie sicherstellen, dass die folgenden Komponenten bereits installiert und konfiguriert sind:
- Home Assistant in der Version ab 2025;
- Ein Raspberry Pi oder ein anderer Computer, auf dem der Home Assistant ausgeführt wird;
- Ein zigbee2mqtt-kompatibler USB-Koordinator (z. B. CC2531 oder CC2652P);
- Der MQTT-Broker, der über Ihr Home Assistant-System verfügbar ist;
Nachdem Sie die erforderlichen Komponenten vorbereitet haben, können Sie mit der Installation von zigbee2mqtt beginnen:
- Öffnen Sie ein Terminal oder eine SSH-Verbindung zu Ihrem Computer, auf dem Home Assistant ausgeführt wird.
- Wechseln Sie in das Verzeichnis, in dem Home Assistant installiert ist.
- Kopieren Sie den folgenden Befehl, und führen Sie ihn aus, um die Zigbee2MQTT-Abhängigkeiten zu installieren:
sudo apt-get update && sudo apt-get upgrade -y && sudo apt-get install -y git make g++ gcc xxd
- Lehnen Sie das Zigbee2MQTT-Repository ab, führen Sie den Befehl aus:
git clone https://github.com/Koenkk/zigbee2mqtt.git /opt/zigbee2mqtt
- Wechseln Sie zum Verzeichnis Zigbee2MQTT und führen Sie den Befehl aus:
- Installieren Sie die Zigbee2MQTT-Abhängigkeiten, führen Sie den Befehl aus:
npm ci --production
- Kopieren Sie die Konfigurationsdatei example-configuration.yaml in configuration.yaml:
cp /opt/zigbee2mqtt/example-configuration.yaml /opt/zigbee2mqtt/configuration.yaml
- Öffnen Sie die Datei /opt/zigbee2mqtt/configuration.yaml in einem Texteditor und passen Sie es an Ihre Konfiguration an.
- Führen Sie Zigbee2MQTT aus, führen Sie den Befehl aus:
Nachdem Sie zigbee2mqtt erfolgreich installiert haben, können Sie Ihre Zigbee-Geräte über den Home Assistant verwalten.
Konfigurieren von zigbee2mqtt in Home Assistant
Die Installation und Konfiguration von zigbee2mqtt in home assistant mag eine schwierige Aufgabe sein, aber mit dieser detaillierten Anleitung wird dies schnell und einfach verlaufen.
1. Der erste Schritt besteht darin, die erforderlichen Pakete zu installieren, damit zigbee2mqtt funktioniert. Öffnen Sie dazu ein Terminal und führen Sie die folgenden Befehle aus:
sudo apt-get update
sudo apt-get install build-essential curl git
2. Nachdem Sie die erforderlichen Pakete installiert haben, können Sie mit der Installation von zigbee2mqtt selbst beginnen. Führen Sie dazu die folgenden Befehle aus:
git clone https://github.com/Koenkk/zigbee2mqtt.git
3. Im nächsten Schritt müssen Sie die Beispielkonfigurationsdatei kopieren und die erforderlichen Einstellungen angeben. Führen Sie dazu die folgenden Befehle aus:
cp data/configuration.yaml.example data/configuration.yaml
4. Bearbeiten Sie im geöffneten Nano-Editor die Konfigurationsdatei mit den erforderlichen Einstellungen wie MQTT-Broker, Port, Benutzername und Passwort. Speichern Sie die Änderungen, und schließen Sie den Editor.
5. Nachdem Sie die Konfiguration konfiguriert haben, können Sie zigbee2mqtt ausführen. Führen Sie dazu den folgenden Befehl aus:
6. Nachdem Sie zigbee2mqtt erfolgreich gestartet haben, können Sie mit dem Anschließen von Zigbee-Geräten beginnen. Halten Sie dazu die Taste auf dem Gerät gedrückt, um die Verbindung herzustellen, und führen Sie den folgenden Befehl aus:
npm run permit-join
7. Jetzt können Sie beginnen, Zigbee-Geräte mit zigbee2mqtt zu verbinden. Befolgen Sie dazu die Anweisungen zum Anschließen jedes einzelnen Geräts.
Glückwunsch! Sie haben zigbee2mqtt erfolgreich im Home Assistant konfiguriert. Jetzt können Sie Zigbee-Geräte in Ihrem Home Assistant-System verwenden.
