# Zigbee2MQTT setup

**Prerequisites**:

- SLZB-07x Zigbee USB coordinator.
- Computer or Raspberry Pi where Zigbee2MQTT or Home Assistant with ZHA will run.
- Home Assistant + ZHA or Zigbee2MQTT software installed.

**Steps**:

1. **Install Zigbee2MQTT**  
    Follow the installation instructions for Zigbee2MQTT based on your system: [https://www.zigbee2mqtt.io/guide/installation/](https://www.zigbee2mqtt.io/guide/installation/)
2. **Connect the Zigbee USB Coordinator**:  
    Plug the SLZB-07x Zigbee USB coordinator into an available USB port on your computer or Raspberry Pi
3. **Configure Zigbee2MQTT**:  
    – Open the Zigbee2MQTT configuration file (usually located at /opt/zigbee2mqtt/data/configuration.yaml or similar).  
    – Find the section related to the coordinator configuration:  
      
    **Configuration for SLZB-07/MGx**  
    ```yaml
    serial:
      port: /dev/ttyUSB0 # Specify the correct serial port for your coordinator
      rtscts: true
      adapter: ember
    ```
    
    <p class="callout warning">Some SLZB-07 dongles may have **adapter: ezsp** from facrory, you can update dongle to use **ember**</p>
    
      
     **Configuration for SLZB-07pX** ```yaml
    serial:
      port: /dev/ttyUSB0 # Specify the correct serial port for your coordinator
      rtscts: false
      adapter: zstack
    ```
    
      
      
    – Ensure that the port matches the serial port where your coordinator is connected. The port might be different based on your system. <p class="callout info">**TIP:**  
    For homeassistant: Go to "Settings" → "System" → "Hardware" → Select the 3 dot menu in the upper right corner → "All Hardware" → Scroll to "ttyUSB" and find your adapter → Copy Device path like "/dev/serial/by-id/usb-\*"  
      
    For linux: list USB devices via command: **ls /dev/ttyUSB\***</p>
4. **Start Zigbee2MQTT Service**:  
    Start or restart the Zigbee2MQTT service to apply the changes made to the configuration file.
5. **Pairing Devices**:  
    Once Zigbee2MQTT is running and configured with the coordinator, you can start pairing Zigbee devices:  
    – Put your Zigbee devices (sensors, bulbs, etc.) into pairing mode according to their respective instructions.  
    – Use Zigbee2MQTT’s interface or command-line tools to initiate the pairing process. Follow the Zigbee2MQTT documentation for the specific commands or steps required.
6. **Device Control and Monitoring**:  
    After successfully pairing your devices, you can control and monitor them using Zigbee2MQTT’s interface or via MQTT messages, depending on your setup.

**Additional Resources**:

- **Zigbee2MQTT Documentation**: The official Zigbee2MQTT documentation provides detailed guides, troubleshooting tips, and a list of compatible devices [https://www.zigbee2mqtt.io/](https://www.zigbee2mqtt.io/)