Обновление Home Assistant

Home Assistant обновляется по-разному в зависимости от типа установки. В Home Assistant OS основной путь - через интерфейс: уведомление в Settings, резервное копирование и кнопка Update, причем Operating System и Core обновляются по отдельности. В Container (Docker) скачивают новый образ Docker и пересоздают на нем контейнер. Если система еще не установлена, начните с инструкции по установке Home Assistant.

Что понадобится

Для безопасного обновления нужны свежая резервная копия, сохраненная вне устройства, где работает Home Assistant, и просмотр примечаний к релизам (release notes) между вашей версией и целевой.

В Home Assistant OS четыре компонента, и каждый обновляется отдельно: Operating System, Supervisor, Core и Apps (приложения, раньше их называли аддонами, add-ons).

Компонент	Как обновляется
Operating System	через интерфейс или командой ha os update
Core	через интерфейс или командой ha core update --backup
Supervisor	порядок обновления в документации не описан
Apps (приложения, add-ons)	порядок обновления в документации не описан

Перед обновлением Core просмотрите release notes всех версий с вашей до целевой и проверьте обратно несовместимые изменения. Для Supervisor и Apps документация называет только команды CLI ha supervisor update и ha host update, без описания процедуры. Номера версий в примерах ниже (15.2, 2026.10.2) взяты из документации и могли устареть.

Обновление через интерфейс

Через интерфейс обновляются и Operating System, и Core, порядок действий одинаковый и описан в документации.

1. Откройте Settings. Когда доступно обновление, сверху появляется уведомление.
2. Если уведомления нет, откройте меню с тремя точками (three dots menu) в правом верхнем углу и выберите Check for updates. Затем перейдите в System > Updates, выберите уведомление, нажмите значок шестеренки (cogwheel) и включите опцию Visible.
3. Включите переключатель резервного копирования (backup toggle), чтобы копия создалась до обновления. Документация рекомендует сделать копию заранее.
4. Откройте уведомление того компонента, который обновляете, и нажмите Update.
5. После обновления проверьте repair issues (сообщения о проблемах) и просмотрите логи.

Обновление из командной строки

Из командной строки обновляются Operating System и Core.

ha os update

Обновляет Operating System до последней доступной версии.

ha os update --version 15.2

Обновляет до конкретной версии (15.2 - пример из документации).

ha core update --backup

Обновляет Core. Флаг --backup сначала создает частичную копию текущей настройки - она выручит, если после обновления понадобится понижение версии.

Резервные копии и восстановление

Перед обновлением стоит сделать свежую копию: из нее восстанавливаются, если нужно понизить версию Core. Порядок работы с копиями описан в общих задачах документации.

Автоматические копии

Откройте Settings > System > Backups, выберите Set up backups и укажите, создавать ли копию автоматически перед обновлением. Это значение по умолчанию, его можно менять перед каждым обновлением. Из-за копии обновление может начаться позже, чем вы ожидали. Время копии выбирайте так, чтобы все места хранения были доступны: иначе копия для недоступных мест не создастся.

Ручная копия

Выберите Backup now > Manual backup, затем Create backup.

Восстановление

Откройте нужную копию и нажмите Restore. Восстановление перезаписывает выбранные части текущей системы. Если восстановление идет в онбординге (первичной настройке), не обновляйте страницу: сообщение Not found может показываться, пока система переустанавливается, просто подождите.

Аварийный набор и интеграция Backup

Для восстановления зашифрованных копий нужен аварийный набор (emergency kit) - храните его вместе с копией в безопасном месте. При удалении старых копий оставляйте хотя бы одну свежую на случай восстановления. Интеграция Backup создает и восстанавливает копии на всех типах установки, а ее действие backup.create создает базовую локальную копию.

Откат и понижение версии

Operating System откатывается сменой слота загрузки, Core - частичным восстановлением резервной копии.

• Если новая версия Operating System не загружается, система автоматически переключается на предыдущий слот загрузки (boot slot - место, откуда запускается версия ОС). При первой установке используется boot slot A.
• Текущий слот показывает команда:

ha os info

• Загрузить предыдущую версию вручную:

ha os boot-slot other

• На платформах с GRUB (загрузчик) меню загрузки показывается в самом начале старта системы.
• Понизить версию Core сменой версии нельзя - вместо этого выполняется частичное восстановление резервной копии.

Обновление в Container

В Container обновление сводится к скачиванию нового образа и пересозданию контейнера. Подробности - в документации для Container.

1. Создайте резервную копию установки и сохраните ее вместе с emergency kit в безопасном месте.
2. Проверьте release notes между вашей версией и целевой. На странице релиза найдите раздел Backward-incompatible changes поиском в браузере (CTRL + f или CMD + f).
3. Скачайте новый образ. Для Docker CLI:

docker pull ghcr.io/home-assistant/home-assistant:stable

Для Docker Compose (скачивание и запуск в фоне):

docker compose pull homeassistant
docker compose up -d

4. Пересоздайте контейнер, чтобы он работал на новом образе. Отдельной команды в документации нет, там отправляют к инструкции по установке на Linux.
5. Перед перезапуском проверьте конфигурацию:

docker exec homeassistant python -m homeassistant --script check_config --config /config

Если контейнер называется не homeassistant, замените имя в команде.

6. После обновления проверьте repair issues и логи.

Текущая версия показана в Settings > About. Для конкретной версии скачайте образ с ее тегом:

docker pull ghcr.io/home-assistant/home-assistant:2026.10.2

Бета и dev-каналы

Ранний доступ к новой версии включается сменой канала Supervisor или скачиванием образа с тегом beta либо dev.

На Home Assistant OS переключите Supervisor на бета-канал, перезагрузите его и обновите Core с копией:

ha supervisor options --channel beta
ha supervisor reload
ha core update --backup

Для dev-канала те же шаги с dev:

ha supervisor options --channel dev
ha supervisor reload
ha core update --backup

В Container для раннего тестирования следующего релиза скачивается образ с тегом beta. Образ с тегом dev скачивается так:

docker pull ghcr.io/home-assistant/home-assistant:dev

Частые проблемы

Опыт пользователей форума: два случая, когда после обновления Home Assistant не запускался.

Проблема	Что помогало пользователям
Обновление падает, и Home Assistant откатывается к предыдущей версии (разбор проблемы, 3 ветки форума)	Дождаться следующего патч-релиза и обновиться снова. По одной отключать пользовательские интеграции из HACS, чтобы найти ту, что ломает запуск
После обновления Home Assistant не стартует, ошибка TypeError: unhashable type: 'list' (2 ветки форума)	Удалить пользовательскую интеграцию, которую автор перестал поддерживать и которую Core теперь включает сам, затем обновиться

Частые вопросы

Чем различаются обновления Core и Operating System?

Core - это сам Home Assistant, Operating System - системное окружение под ним, и в Home Assistant OS они обновляются по отдельности. Оба обновляются через интерфейс одним способом, а из командной строки - командами ha core update --backup и ha os update. Supervisor и Apps (приложения, add-ons) - тоже отдельные компоненты, но порядок их обновления в документации не описан.

Можно ли обновляться без резервной копии?

Документация рекомендует сначала создать копию. В интерфейсе для этого есть backup toggle, в командной строке - флаг --backup у команды ha core update --backup. Копия дает путь к откату: Core понижается частичным восстановлением, а не сменой версии. Учтите, что из-за копии обновление может начаться позже.

Как вернуть предыдущую версию после неудачного обновления?

Порядок зависит от компонента. Operating System при неудачной загрузке сама переключается на предыдущий boot slot, вручную то же делает команда ha os boot-slot other, а текущий слот показывает ha os info. Версия Core понижается частичным восстановлением резервной копии. В Container скачивается образ с тегом нужного релиза, например 2026.10.2, после чего контейнер пересоздается.

Почему обновление началось позже, чем ожидалось?

Возможная причина - резервная копия перед обновлением: документация предупреждает, что из-за нее обновление может начаться позже. Настройка работает как значение по умолчанию для всех обновлений, но перед каждым ее можно изменить. Время копии выбирайте так, чтобы все места хранения были доступны и работали.

Чем бета-канал отличается от dev?

Бета позволяет протестировать следующий релиз раньше всех, а ветка dev, вероятно, нестабильна. На Home Assistant OS канал Supervisor переключается командой ha supervisor options --channel beta (или dev), затем выполняются ha supervisor reload и ha core update --backup. В Container вместо stable-образа скачивается образ с тегом beta или dev. Документация предупреждает о потере данных и повреждении установки.