> For the complete documentation index, see [llms.txt](https://pekaway.gitbook.io/van-pi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pekaway.gitbook.io/van-pi/wirelesss-and-network/zigbee.md).

# Zigbee

### Anleitung zur Einbindung von Zigbee-Geräten

#### 1. Zigbee-Stick verbinden

* **Schritt 1:** Verbinden Sie den Zigbee-Stick mit dem **VanPi Core**. Verwenden Sie hierfür **USB-Port 2**.

#### 2. Webinterface aufrufen

* **S chritt 2:** Öffnen Sie das Webinterface des VanPi Core. Die Adresse lautet: `IP-Adresse:1880/ui`.
* **Schritt 3:** Navigieren Sie im Webinterface zu **Config > Wireless** und aktivieren Sie die Option **"Enable/Disable Zigbee2Mqtt"**.

![](https://t9012319662.p.clickup-attachments.com/t9012319662/48309545-791a-4bcc-9430-17ebab861219/image.png)

#### 3. Zigbee2MQTT Admin Panel aufrufen

* **Schritt 4:** Rufen Sie nun das **Zigbee2MQTT Admin Panel** auf.

#### 4. Geräte anlernen

* **Schritt 5:** Klicken Sie auf **"Anlernen aktivieren"**, um den Anlernmodus zu starten, und fügen Sie die entsprechenden Geräte hinzu.
* **Hinweis:** Die hinzugefügten Geräte erhalten eine ID, die später noch benötigt wird.

#### ![](https://t9012319662.p.clickup-attachments.com/t9012319662/2f74dbb2-7987-4918-b718-594c016ad5d4/image.png)

#### 5. Backend von VanPi OS öffnen

* **Schritt 6:** Öffnen Sie das Backend von **VanPi OS** über die Adresse: `IP-Adresse:1880`.
* **Schritt 7:** In der linken Spalte finden Sie die Kategorie **ZigBee2mqtt**. Fügen Sie hier die **"In" Node** hinzu.

![](https://t9012319662.p.clickup-attachments.com/t9012319662/60cb41f4-9786-4bc1-9cad-cc4a72bde7c3/image.png)

#### 6. Node mit MQTT-Server verbinden

* **Schritt 8:** Verbinden Sie die Node mit dem entsprechenden MQTT-Server. Öffnen Sie die Node per Doppelklick und editieren Sie den Punkt **"Server"**.
* **Schritt 9:** Tragen Sie unter **MQTT Host** den Wert **"localhost"** ein und übernehmen Sie die Einstellungen.
* **Schritt 10:** Um das hinzugefügte Gerät in der **Device-Liste** anzuzeigen, drücken Sie auf **Übernahme (Deploy)**.

![](https://t9012319662.p.clickup-attachments.com/t9012319662/508cfe40-9816-4ae5-965e-ff507c0ec6d7/image.png)7. Gerät überprüfen

* **Schritt 11:** Öffnen Sie die hinzugefügte Node erneut und überprüfen Sie, ob die ID des Geräts unter **Device** angezeigt wird.

Damit ist Einbindung des Geräts im VanPi OS abgeschlossen, sie können nun entsprechende Nodes Hinzufügen und Aktionen ausführen.Info: Beispiel Konfigurationen werden in Zukunft via Update nachgeliefert


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://pekaway.gitbook.io/van-pi/wirelesss-and-network/zigbee.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.