Проблемы и решения

Устройства спарены с Zigbee2MQTT и видны в его веб-интерфейсе, но в Home Assistant их нет среди устройств и сущностей. Это проблема discovery - механизма, которым Zigbee2MQTT сообщает Home Assistant о новых устройствах…

Ошибка Error: Failed to start EZSP layer with status=HOST_FATAL_ERROR. означает, что Zigbee2MQTT не смог запустить слой EZSP - протокол, по которому он обменивается данными с координаторами на чипах Silicon Labs.…

Ошибка Error: Failed to connect to the adapter (Error: SRSP - SYS - ping after 6000ms) означает, что Zigbee2MQTT не может связаться с Zigbee-координатором (донглом или сетевым модулем, который ведет сеть Zigbee):…

После обновления Zigbee2MQTT до версии 2.0 кнопки и пульты нередко выпадают из автоматизаций: сенсоры вида sensor.*_action исчезают, и у устройства в Home Assistant остаются только уровень батареи и качество связи.…

Zigbee2MQTT не запускается, когда тип Zigbee-адаптера не задан в секции serial или задан неверно. Обычно помогает одно из двух: прописать в configuration.yaml правильное значение adapter - zstack для донглов на чипе…

После обновления прошивки координатора SMLIGHT SLZB-06 (это адаптер, который управляет всей Zigbee-сетью) Zigbee2MQTT может перестать запускаться - в логе появляется ошибка network commissioning timed out, а иногда…

Ошибка spawn udevadm ENOENT возникает при запуске аддона Zigbee2MQTT (дополнения для Home Assistant) и не дает ему стартовать. В ветках форума причиной называли конфигурацию Zigbee2MQTT и USB-донгл, занятый интеграцией…

Аддон Zigbee2MQTT при первом запуске открывает страницу onboarding - мастер первоначальной настройки адаптера и MQTT. Иногда мастер застревает: поля на странице серые и недоступные, а настройка не завершается. Обычно…

После обновления Home Assistant до версии 2024.2.1 интеграция Tuya просит пройти повторную аутентификацию: запрашивает User Code и предлагает сканировать QR-код приложением Smart Life. Помогали два шага, у каждого по…

Ошибка Unknown error occurred в интеграции Tuya появляется после ввода User Code - кода пользователя Tuya, который интеграция запрашивает при входе. QR-код не появляется, и вход не завершается. Судя по собранным веткам…

Обновление Home Assistant падает, и Supervisor (компонент, который управляет обновлениями и аддонами) автоматически откатывает систему на прежнюю версию. Проблема встречалась на обновлениях до 2025.4, 2026.3.2 и…

Ошибка «Adapter EZSP protocol version is not supported by Host» означает, что Zigbee2MQTT (хост) и прошивка донгла работают на разных версиях протокола EZSP - так Zigbee2MQTT общается с прошивкой EmberZNet на адаптере.…

Ошибка No valid USB adapter found означает, что Zigbee2MQTT при запуске не смог определить валидный USB-адаптер: discovery (автоматическое определение устройств) не находит подходящий донгл, и аддон (дополнение Home…

Аддон Zigbee2MQTT (дополнение Home Assistant) после потери связи с координатором не поднимается сам: встроенный watchdog, то есть механизм автоперезапуска, делает две попытки и прекращает работу. В логе при этом видны…

Координатор ZBT-2 не находит Sonoff ZBDongle-E, перепрошитый под роутер (устройство, расширяющее покрытие Zigbee-сети), либо ZHA (интеграция Zigbee в Home Assistant) определяет донгл как сам координатор. Обычно помогает…

Ошибка MQTT failed to connect, exiting... означает, что Zigbee2MQTT не смог подключиться к MQTT-брокеру и завершил работу сразу после запуска. В ветках форума помогали правки на стороне самого Zigbee2MQTT: настройки…

HACS установлен через Get HACS, но интеграция не появляется в списке Add Integration и в боковой панели Home Assistant. В ветках форума помогала переустановка HACS способом, который соответствует типу установки Home…

В Home Assistant OS (HAOS) на x86 Wi-Fi-адаптер может не работать: плата или USB-донгл не показывается как Wi-Fi устройство, а привычного apt-get для установки драйверов в системе нет. В двух ветках адаптер уже был…

Home Assistant OS при первой загрузке ожидает проводное подключение к сети. На старом ноутбуке без порта Ethernet загрузка остановилась на предупреждении [WARN] Home Assistant CLI not starting! Jump into emergency…

OTA - обновление прошивки устройства по радиоканалу, а OTA-файл - готовый образ такой прошивки. Начиная с версии Home Assistant 2024.1 интеграция ZHA не предлагает обновления из внешних OTA-файлов. Пользователям форума…

Клапан полива GIEX GX-02 не дает в ZHA (штатной Zigbee-интеграции Home Assistant) рабочего управления, пока для него не установлен свой quirk - обработчик устройства под конкретную модель. Пользователям помогал quirk с…

Ошибка is NOT supported означает, что устройство подключилось к Zigbee-сети, но в установленной версии Zigbee2MQTT для него нет конвертера - описания, по которому у устройства появляются сущности. В одной из веток…

В Home Assistant пропала сущность (entity) лампы или другого устройства Zigbee, подключенного через Zigbee2MQTT: после удаления устройства и повторного сопряжения она не возвращается, хотя в самом Zigbee2MQTT устройство…

Zigbee-донгл Sonoff, подключенный к Home Assistant в виртуальной машине (ВМ) на компьютере с Windows, после перезагрузки основной системы (хоста) или самой ВМ перестает определяться, и интеграция сообщает, что путь…