Новые версии Home Assistant выходят регулярно: крупные релизы обычно раз в месяц, а между ними небольшие исправляющие выпуски. Своевременное обновление Home Assistant закрывает уязвимости, исправляет ошибки и добавляет возможности. Но каждое обновление — это риск: могут перестать работать отдельные интеграции или карточки. В статье разберём безопасный порядок действий, команды для HAOS и Docker, а также то, что делать, если Home Assistant не обновляется, и как правильно перезагрузить систему.

1Что понадобится
- Доступ к интерфейсу по адресу вида
http://homeassistant.local:8123или по IP и порту 8123. - Свободное место на накопителе: для загрузки и распаковки обновления нужен запас.
- Стабильный интернет на сервере: обновление скачивается из сети.
- Возможность сделать резервную копию и сохранить её вне самого сервера.
- Для работы с консолью: доступ по SSH, дополнение «Terminal & SSH» или подключённые к серверу монитор и клавиатура. Для Docker — доступ к хосту.
2Что именно обновляется
В установке Home Assistant OS обновляются несколько независимых компонентов, и их полезно различать.
- Home Assistant Core — само приложение с интеграциями и интерфейсом. Обновляется чаще всего.
- Supervisor — служба, управляющая дополнениями, резервными копиями и обновлениями. Обычно обновляется автоматически.
- Home Assistant Operating System — сама операционная система. Обновляется реже, после установки обычно требуется перезагрузка устройства.
- Дополнения (add-ons) — отдельные приложения вроде Zigbee2MQTT, MQTT-брокера, Terminal. У каждого свой номер версии.
- Пользовательские компоненты и карточки из HACS — обновляются отдельно через HACS и могут быть несовместимы с новой версией Core.
В установках Container и Core Supervisor и операционной системы нет, и обновление ограничивается образом контейнера или пакетом Python.

3Шаг 1. Подготовьтесь к обновлению
- Прочитайте заметки о выпуске. На странице релиза в блоге проекта есть раздел «Breaking changes» (критические изменения): в нём указано, что перестанет работать или изменит поведение. Ищите там названия интеграций, которыми пользуетесь.
- Проверьте, не устарели ли пользовательские компоненты. Если у вас стоят интеграции из HACS, убедитесь, что для них есть обновления, совместимые с новой версией.
- Освободите место. Откройте «Настройки», «Система», «Хранилище» (название раздела может отличаться в разных версиях) и посмотрите свободное место. Если его мало, удалите старые резервные копии и лишнее.
- Сделайте резервную копию. Это обязательный шаг, который выручит, если обновление пойдёт не так. Подробности в следующем разделе.
- Выберите момент. Не обновляйтесь за минуту до отъезда в отпуск. Лучше, когда есть время откатиться.
4Шаг 2. Резервная копия перед обновлением
Откат версии в Home Assistant делается через восстановление резервной копии. Отдельной кнопки «вернуть предыдущую версию» нет, поэтому копия нужна всегда.
- Откройте «Настройки», затем «Система», затем «Резервные копии».
- Создайте новую копию. Для обновления Core обычно достаточно полной копии или копии с основными настройками и нужными дополнениями.
- Скачайте копию на компьютер или убедитесь, что настроено автоматическое сохранение во внешнее хранилище. Копия, которая лежит только на том же накопителе, не защитит от его отказа.
Перед обновлением из окна обновления тоже можно включить создание копии. Если такой переключатель есть, оставьте его включённым. Расположение пунктов в разных версиях может отличаться.
5Шаг 3. Обновление из интерфейса
- Откройте «Настройки». Если доступны обновления, вверху страницы появится соответствующий блок или счётчик. Полный список находится в разделе обновлений в настройках (в актуальных версиях это «Настройки», «Система», «Обновления»; путь может измениться).
- Нажмите на нужный пункт, например Home Assistant Core. Откроется окно с описанием версии.
- Прочитайте заметки о выпуске по ссылке в окне.
- Убедитесь, что включено создание резервной копии перед обновлением, если такой переключатель предложен.
- Нажмите кнопку обновления и дождитесь завершения. Интерфейс на время перезапуска станет недоступен: это нормально. Не выключайте питание.
- Когда страница снова откроется, войдите и проверьте основные функции: освещение, датчики, автоматизации.
Порядок обновления компонентов лучше такой: сначала Supervisor и операционная система (если они предлагаются), затем Core, затем дополнения. Если обновлений много, не делайте всё одновременно: так проще понять, что вызвало проблему.
6Шаг 4. Обновление через командную строку (HAOS)
В Home Assistant OS есть консоль Home Assistant CLI. Она доступна на экране подключённого к серверу монитора, а также через SSH-дополнение. Основные команды:
| Команда | Что делает |
|---|---|
ha core update |
Обновляет Home Assistant Core до последней доступной версии |
ha core update --version 2024.1.0 |
Обновляет до указанной версии (номер подставьте нужный; пример условный) |
ha core check |
Проверяет конфигурацию на ошибки |
ha core restart |
Перезапускает Home Assistant Core |
ha core logs |
Выводит журнал Core |
ha supervisor update |
Обновляет Supervisor |
ha os update |
Обновляет операционную систему |
ha backups new --name before-update |
Создаёт резервную копию с указанным именем |
Названия и параметры команд проверяйте по подсказке ha help или ha core --help: они могут быть изменены в новых версиях. Типичная последовательность выглядит так:
ha backups new --name before-update
ha core check
ha core update
ha core logs
Команда ha core check перед обновлением выявляет проблемы с конфигурацией, а после обновления помогает понять, почему система не стартует.
7Шаг 5. Обновление в Docker (Container)
В установке Container интерфейс обновлений не знает, как менять образ: это делаете вы. Принцип: получить новый образ и пересоздать контейнер. Сначала сделайте копию каталога с конфигурацией: именно в нём хранятся ваши данные.
docker pull ghcr.io/home-assistant/home-assistant:stable
Если контейнер описан в файле Docker Compose, делается так:
docker compose pull
docker compose up -d
Compose заметит новый образ и пересоздаст контейнер с прежним каталогом конфигурации. Если вы запускали контейнер командой docker run, остановите и удалите старый контейнер и запустите новый с теми же параметрами. Данные при этом сохранятся, так как лежат в подключённом каталоге, а не внутри контейнера. Если вы указали конкретный тег версии, замените его на нужный. После запуска проверьте журнал: docker logs имя-контейнера.
8Как правильно перезагрузить Home Assistant
Различайте три действия, потому что они не равнозначны.
- Перезагрузка конфигурации. Для многих разделов (автоматизации, скрипты, сцены) в «Инструменты разработчика», вкладка YAML, есть кнопки перезагрузки без остановки системы. Это самый мягкий вариант.
- Перезапуск Home Assistant Core. Через значок питания в правом верхнем углу в «Настройки», «Система» либо командой
ha core restart. Обязателен после установки новых компонентов, например через HACS. - Перезагрузка всего устройства. Нужна после обновления операционной системы или при проблемах с самим сервером. В интерфейсе и CLI для этого есть соответствующие пункты; для HAOS это команда
ha host reboot.
Перед перезапуском проверяйте конфигурацию: в «Инструменты разработчика», вкладка YAML, есть проверка конфигурации. Если в файле ошибка, Home Assistant может не подняться после перезапуска. Для HAOS подойдёт ha core check.
9Что делать, если Home Assistant не обновляется
Проблемы с обновлением почти всегда сводятся к ограниченному набору причин. Идите по списку.
1. Нет места на накопителе
Обновление скачивает образ и создаёт резервную копию. Если места мало, процесс обрывается с ошибкой. Удалите старые резервные копии, лишние дополнения, сократите срок хранения истории в recorder.
2. Нет доступа к интернету или не работает DNS
Проверьте, что сервер выходит в сеть. В консоли HAOS посмотрите состояние сети командой ha network info, а из терминала проверьте разрешение имён. Нередкая причина — неверно заданный DNS в настройках сети сервера или блокировка на роутере. Если в вашей сети есть ограничения доступа к некоторым ресурсам, обновление может скачиваться нестабильно; тогда помогает смена DNS или использование VPN на уровне сети.
3. Supervisor в состоянии «нездоров» или «не поддерживается»
В «Настройки», «Система», «Здоровье» (название зависит от версии) может быть указано, что система неисправна или установка не поддерживается. В этом случае обновления блокируются. В описании причины обычно указано, чего именно не хватает. Это может быть проблема с накопителем, неверное системное время, несовместимая среда. Устраняйте причину по подсказке.
4. Неверное системное время
Если часы на сервере сильно расходятся с реальными, защищённые соединения не устанавливаются. Проверьте время и часовой пояс, при необходимости включите синхронизацию.
5. Версия слишком старая
Если вы очень давно не обновлялись, прыжок через много версий может не пройти. В таких случаях проект рекомендует обновляться поэтапно через промежуточные выпуски и читать список критических изменений на каждом шаге. Конкретные требования к промежуточным версиям смотрите в заметках к релизам.
6. Несовместимые пользовательские компоненты
После обновления Core система может не стартовать из-за стороннего компонента. Тогда зайдите в журнал, найдите сообщение с названием компонента. Временно уберите его из каталога custom_components или обновите в HACS. Затем перезапустите систему.
7. Обновление зависло
Если интерфейс не отвечает дольше обычного, подождите: на слабом железе обновление может занимать много времени. Не выдёргивайте питание сразу. Если через длительное время ничего не изменилось, посмотрите журнал через консоль: ha core logs и ha supervisor logs. При необходимости перезагрузите устройство и повторите попытку.
8. Ошибка в конфигурации
Выполните ha core check. Исправьте ошибки в файлах конфигурации, указанные в выводе.
10Откат, если стало хуже
Если после обновления что-то сломалось и быстро исправить не получается, восстановите резервную копию. Откройте «Настройки», «Система», «Резервные копии», выберите копию, сделанную перед обновлением, и запустите восстановление. Если интерфейс недоступен, копию можно восстановить при начальной настройке либо через CLI. В Docker откат делается указанием предыдущего тега образа и возвратом каталога конфигурации из архива. Обратите внимание: база данных новой версии иногда несовместима со старой, поэтому полный откат безопаснее выполнять именно вместе с данными из копии.
11Типичные ошибки и как их избежать
| Ошибка | Последствия | Как избежать |
|---|---|---|
| Обновление без резервной копии | Нет возможности откатиться | Всегда делать копию и хранить её вне сервера |
| Игнорирование списка критических изменений | Неожиданно перестают работать интеграции | Читать заметки о выпуске перед обновлением |
| Обновление всего сразу | Трудно найти причину проблемы | Обновлять по одному компоненту |
| Выключение питания во время обновления | Повреждение системы или базы данных | Дожидаться окончания, использовать ИБП |
| Забытые HACS-компоненты | Сбои после перехода на новую версию | Обновлять компоненты HACS и проверять совместимость |
| Мало свободного места | Обновление обрывается | Очистить накопитель до начала |
| Обновление Docker без сохранения каталога конфигурации | Потеря настроек | Хранить конфигурацию в подключённом каталоге и копировать его |
12Автоматические обновления: стоит ли включать
В Home Assistant можно получать уведомления о выходе версий, а для некоторых дополнений доступно автоматическое обновление. Для Core и критичных дополнений лучше выполнять обновление вручную: вы читаете заметки и выбираете момент. Автообновление имеет смысл только для второстепенных дополнений, сбой в которых не нарушит работу дома. Если вы хотите быть в курсе новинок, подпишитесь на уведомления о выходе версий и держите в запасе свежую копию.
13Как следить за выходом версий и не отстать
Удобная привычка — раз в месяц, через неделю-две после выхода крупного релиза, обновляться на версию с первыми исправлениями. В первые дни после релиза часто выходят небольшие патчи с исправлением найденных ошибок, и осторожные пользователи ждут их. Так вы избегаете большинства сюрпризов, а отставание от актуальной версии остаётся небольшим. Не откладывайте обновление на год: чем больше пропущено версий, тем сложнее переход и тем длиннее список критических изменений.
14Проверка после обновления
После каждого обновления потратьте пять минут на проверку. Откройте журнал в «Настройки», «Система», «Журналы» и убедитесь, что нет множества новых ошибок. Просмотрите раздел «Устройства и службы»: интеграции, которым нужна повторная настройка, помечены отдельно. Проверьте, что запускаются ключевые автоматизации, а карточки на главной панели отображаются нормально. Если какая-то карточка пропала, чаще всего причина в обновившемся пользовательском ресурсе из HACS, который нужно обновить, а страницу — перезагрузить с очисткой кэша браузера.
Если вы пользуетесь мобильным приложением, после крупных обновлений полезно обновить и его, чтобы версия приложения не отставала от сервера. Нередко именно устаревшее приложение вызывает странные ошибки в уведомлениях и датчиках телефона.
15Обновление дополнений
Дополнения обновляются по тем же принципам: прочитайте описание изменений, сделайте копию, обновляйте по одному. Особую осторожность проявляйте с дополнениями, хранящими данные: брокер MQTT, Zigbee2MQTT, базы данных. Перед их обновлением копия особенно важна, а после обновления проверьте, что устройства по-прежнему отвечают. Для некоторых дополнений доступно автоматическое создание копии при обновлении, и эту возможность стоит использовать.
16Если интерфейс не открывается после обновления
Иногда после перезапуска страница долго не загружается. Сначала подождите: после крупных обновлений идёт миграция базы данных, и на слабом железе она может занять заметное время. Затем проверьте доступность сервера по адресу и порту 8123, а в консоли HAOS посмотрите состояние командой ha core info и журнал командой ha core logs. Если в журнале указана ошибка конфигурации, исправьте файл и выполните ha core check. Если причина в стороннем компоненте, отключите его и перезапустите систему. Только когда исправить не удаётся, переходите к восстановлению из резервной копии.
17Итог
Безопасное обновление Home Assistant сводится к простой цепочке: прочитать заметки о выпуске, проверить свободное место, сделать резервную копию, обновить компоненты по одному и проверить работу. На HAOS команды ha core update, ha core check и ha core restart дают полный контроль из консоли, в Docker достаточно получить новый образ и пересоздать контейнер. Если обновление не идёт, ищите причину в нехватке места, сети, статусе Supervisor и сторонних компонентах, а при серьёзном сбое восстанавливайте резервную копию.
Вопросы и ответы
Как обновить Home Assistant?
Откройте раздел обновлений в Настройках, прочитайте заметки о выпуске, сделайте резервную копию и запустите обновление. В HAOS это можно сделать и командой ha core update, а в Docker достаточно получить новый образ и пересоздать контейнер.
Нужно ли делать резервную копию перед обновлением?
Да, это обязательный шаг. Отдельной кнопки отката версии нет, поэтому вернуться к рабочему состоянию можно только восстановлением копии.
Почему Home Assistant не обновляется?
Чаще всего не хватает места на накопителе, нет доступа к интернету или DNS, Supervisor помечен как неисправный либо неверно системное время. Проверьте эти пункты и журнал командой ha core logs.
Как перезагрузить Home Assistant?
Для перезапуска Core используйте меню питания в Настройках, раздел Система, или команду ha core restart. Перед перезапуском проверьте конфигурацию командой ha core check или в инструментах разработчика.
Как обновить Home Assistant в Docker?
Скачайте новый образ командой docker pull ghcr.io/home-assistant/home-assistant:stable либо docker compose pull, затем пересоздайте контейнер. Данные сохранятся, если каталог конфигурации подключён к контейнеру.



