A monitor and small Zigbee coordinator on a wooden desk

ZIGBEE2MQTT AND HOME ASSISTANT

Zigbee device refuses to pair?

Separate coordinator, permit-join, device mode, and MQTT state, then verify control and a restart before adding more devices.

  • One coordinator and one device
  • Permit-join and device mode checked
  • Control, state, and restart verified

THE THREE FAILURES WE SEE

What is going wrong?

01

Permit join never finds it

Zigbee2MQTT is in permit-join mode, but the device never appears in the interview list.

02

Interview starts then fails

The device appears briefly, then the interview stalls or the device is marked unsupported.

03

Paired but uncontrollable

The device is in the list, but state updates or commands do not reach it.

HOW WE TEST

Find the failing layer, then prove the fix.

  1. Confirm the coordinator. Check the adapter is detected, the serial path is stable, and the coordinator firmware is supported. A coordinator offline explains every pairing failure.
  2. Enable permit join. Allow join for the intended duration and keep the device close during the interview. Check the Zigbee2MQTT log, not only the dashboard.
  3. Reset the device correctly. Use the manufacturer's pairing/reset sequence; holding a button for the wrong duration can factory-reset or do nothing.
  4. Verify control after restart. Toggle the device, read its state, then restart Zigbee2MQTT and repeat.
Zigbee2MQTT dashboard showing a paired device and MQTT state
A paired interview is not enough; control and state must survive a restart.

SERVICE SCOPE

What is included

Included

  • One coordinator and one Zigbee device
  • Coordinator/serial and permit-join checks
  • Device reset and interview review
  • Control and restart verification

Not included

  • Electrical wiring or mains installation
  • Buying new hardware
  • Custom converter development
  • Guaranteeing every end device

The session covers one agreed device and one verified path. Anything outside the written scope is quoted separately before work starts.

FAQ

Before you book

Should I pair all devices at once?

No. Pair one known device first so the coordinator, permit-join, and MQTT path are proven before adding more.

Why does the device disappear after a restart?

The interview may not have completed, or the device is not reaching the coordinator. Check the log and the network path.

Can you fix faulty hardware?

No. We isolate coordinator, pairing, and MQTT issues; physical repair or wiring is outside scope.

NEXT STEP

Tell us what is happening.

Send the device, software, exact symptom, and what you have already tried. We will confirm scope and a fixed quote before booking.

No passwords. A real reply comes from [email protected].

FROM THE BLOG

Zigbee2MQTT Pairing Help Guides

All guides