Step 1: Turn On Debug Logging

1. Open Home Assistant in your web browser.

2. Go to Settings → Integrations.

3. Find Zigbee Home Automation (ZHA) and click on it.

4. Click the three dots menu in the top-right corner.

5. Select Enable Debug Logging.

This temporarily records detailed information about your Zigbee network, including pairing attempts.

Step 2: Attempt to Pair Your Device

1. Put your Zigbee device into pairing mode.

2. Try pairing it in Home Assistant as you normally would.

3. Allow a few minutes for the device to communicate so sufficient log data is collected.

Step 3: Download the Log

1. Return to the same three dots menu in the ZHA integration page.

2. Disable debug logging.

3. Home Assistant will automatically create a debug log file.

4. Download the file and send it to us for review.

This log contains all the steps Home Assistant took while pairing your device, which helps identify the issue quickly.