Обновление Home Assistant 2025.12: отключение legacy template entities и что с этим делать

Введение

Начиная с версии Home Assistant 2025.12 старый формат работы с legacy template entities официально объявлен устаревшим (deprecated). Это означает, что данный механизм больше не развивается и в будущем будет полностью удалён из системы.

Поддержка legacy template entities сохранится до версии 2026.6, после чего они перестанут загружаться и использоваться. Поэтому уже сейчас имеет смысл запланировать переход на новый синтаксис и актуальные механизмы Home Assistant. В этом материале разобраны сами изменения и практические шаги, которые помогут спокойно подготовиться к миграции.

Обновление Home Assistant 2025.12 и legacy template entities

В версии 2025.12 Home Assistant официально объявляет deprecation legacy template entities — старого способа описания шаблонных сущностей через platform: template. Это решение связано с дальнейшими архитектурными изменениями платформы и тем, что поддержка старой модели больше не вписывается в планы развития проекта. Более подробно причины и контекст можно прочитать в обсуждении на форуме.

Deprecation затрагивает legacy template entities следующих типов:

• alarm_control_panel
• binary_sensor
• cover
• fan
• light
• lock
• sensor
• switch
• vacuum
• weather

До версии 2026.6 такие сущности продолжат работать, но они считаются устаревшими и их использование будет сопровождаться предупреждениями в разделе «Устранение проблем». Этот раздел доступен по пути Настройки → Система → Устранение проблем.

Пример типичного предупреждения для шаблонных штор (cover):

Legacy cover template deprecation
Предупреждение Представлено интеграцией Template
Это приведет к неисправностям в версии 2026.6. Пожалуйста, устраните эту проблему перед обновлением.
Устаревший синтаксис platform: template для cover будет удалён. Пожалуйста, перенесите curtains на современный синтаксис шаблонов.

Как исправить конфигурацию после обновления

Правильный путь — постепенный переход на современный template синтаксис, который активно поддерживается и развивается. Для этого достаточно отказаться от legacy-объявлений platform: template и использовать актуальный синтаксис template:.

Предупреждение в разделе «Устранение проблем» обычно содержит подробную подсказку по исправлению. В нём прямо указывается, какой фрагмент конфигурации считается устаревшим и на какой формат его следует заменить.

Например, если ранее использовалась такая конфигурация штор:

- platform: template
  covers:
    curtains:
      unique_id: curtains
      device_class: curtain
      friendly_name: "Шторы"
      optimistic: true
      close_cover:
        - service: script.close_curtains
      open_cover:
        - service: script.open_curtains

Её необходимо заменить на современный вариант:

template:
- cover:
  - unique_id: curtains
    device_class: curtain
    optimistic: true
    close_cover:
    - action: script.close_curtains
    open_cover:
    - action: script.open_curtains
    default_entity_id: cover.curtains
    name: Шторы

Если раньше шаблонные сущности были разнесены по отдельным файлам, например covers.yaml или sensors.yaml, эту схему можно сохранить и при переходе на новый подход. Для этого используется стандартный механизм !include.

Пример организации файлов:

В configuration.yaml:

# Include files
template: !include templates.yaml

В templates.yaml:

# Include files
- cover: !include covers.yaml
- sensor: !include sensors.yaml

В covers.yaml:

- name: "Шторы"
  unique_id: curtains
  device_class: curtain
  optimistic: true
  open_cover:
    - action: script.open_curtains
  close_cover:
    - action: script.close_curtains

Такой вариант удобен при большом количестве шаблонных сущностей и помогает поддерживать конфигурацию аккуратной и понятной.

Итоги и рекомендации

Home Assistant 2025.12 — это не поломка и не срочная проблема, а понятный сигнал к подготовке. Legacy template entities пока продолжают работать, но их жизненный цикл ограничен версией 2026.6. Оптимальная стратегия — использовать период между 2025.12 и 2026.6 для плановой миграции, без спешки и экстренных исправлений.

Полезные ссылки

• Инструкция миграции legacy template entities — официальное руководство по переходу на новый template синтаксис.
• Обсуждение Deprecation of legacy template entities — причины изменений, планы разработчиков и обсуждение в сообществе.