Перед удалением Home Assistant первым делом проверьте, каким способом система была установлена: Home Assistant OS на отдельном устройстве, контейнер Docker, метод Supervised или виртуальное окружение Python (core) — от этого зависит вся процедура. Удаление контейнера без очистки томов оставит гигабайты конфигураций, а стирание SD-карты без бэкапа уничтожит историю датчиков и настроенные автоматизации.
В этой инструкции разберём каждый вариант установки отдельно: как сохранить резервную копию, корректно остановить службы, удалить программные компоненты и убедиться, что в системе не осталось следов. Откройте терминал или веб-интерфейс и следуйте разделу, соответствующему вашему типу развёртывания.
Шаг 1. Создайте резервную копию перед удалением
Даже если вы уверены, что Home Assistant больше не понадобится, сделайте полный снапшот. Восстановить удалённую конфигурацию невозможно, а через месяц может понадобиться старая автоматизация или история энергопотребления.
В веб-интерфейсе перейдите в Настройки → Система → Резервные копии и создайте полную копию. Скачайте файл архива на компьютер — хранить его на том же носителе, который будете очищать, бессмысленно.
- 💾 Создайте полную резервную копию через веб-интерфейс, а не частичную.
- 📥 Скачайте архив на внешний носитель или другой компьютер.
- 🔑 Сохраните пароль шифрования бэкапа, если он задан.
- 📋 Выпишите токены доступа и пароли интеграций, если планируете миграцию.
Шаг 2. Определите тип установки
Способ удаления напрямую зависит от метода развёртывания. Если вы не помните, как ставили систему, есть простые признаки для определения.
Откройте Настройки → Система → Сведения о системе — там указан тип установки. Либо проверьте на хост-машине: команда docker ps покажет контейнеры, а служба home-assistant@homeassistant в systemctl укажет на установку в venv.
| Тип установки | Как распознать | Сложность удаления |
|---|---|---|
| Home Assistant OS | Отдельное устройство или VM, только HA | Простая — стереть диск |
| Container (Docker) | Контейнер homeassistant в docker ps | Средняя |
| Supervised | Несколько контейнеров hassio_* | Сложная |
| Core (venv) | Служба systemd, папка venv | Средняя |
Шаг 3. Удаление Home Assistant OS
Это самый простой сценарий: операционная система целиком посвящена Home Assistant, поэтому удаление сводится к очистке носителя. Для Raspberry Pi извлеките SD-карту и отформатируйте её на компьютере — подойдёт стандартное средство форматирования или Raspberry Pi Imager с функцией очистки.
Если система работала в виртуальной машине (Proxmox, VirtualBox, VMware), остановите ВМ и удалите её вместе с виртуальными дисками через интерфейс гипервизора. Не забудьте снять галочку «сохранить диски», если она предлагается.
☑️ Удаление Home Assistant OS
Шаг 4. Удаление контейнера Docker
Для установки типа Container недостаточно просто удалить контейнер — конфигурация хранится в примонтированном томе на хосте. Сначала остановите и удалите контейнер:
docker stop homeassistant
docker rm homeassistant
Затем удалите образ и папку с конфигурацией. Путь к ней вы указывали при запуске в параметре -v — чаще всего это что-то вроде /home/user/homeassistant или /opt/homeassistant.
docker rmi ghcr.io/home-assistant/home-assistant:stable
rm -rf /путь/к/конфигурации
Если использовался docker-compose, выполните docker compose down в каталоге с файлом docker-compose.yml, затем удалите сам файл и папку данных.
⚠️ Внимание: команда rm -rf необратима. Перед выполнением трижды проверьте путь — ошибка в одном символе удалит не тот каталог. Убедитесь, что резервная копия скачана и открывается.
Шаг 5. Удаление Supervised-установки
Метод Supervised самый «грязный» с точки зрения удаления: помимо основного контейнера он ставит supervisor, observer, dns, audio, cli и агент os-agent на уровне хоста. Нужно удалить всё.
Остановите и удалите все связанные контейнеры и службы:
docker stop $(docker ps -q --filter "name=hassio")
docker stop $(docker ps -q --filter "name=homeassistant")
systemctl stop hassio-supervisor.service
systemctl disable hassio-supervisor.service
После этого удалите пакет os-agent через dpkg, каталоги /usr/share/hassio и /etc/hassio, а также службы systemd, оставленные установщиком. Точный список файлов зависит от версии установщика — сверяйтесь с официальной документацией репозитория home-assistant/supervised-installer.
Шаг 6. Удаление установки Core (Python venv)
При установке в виртуальное окружение Home Assistant работает как служба systemd от отдельного пользователя. Сначала остановите и отключите службу:
sudo systemctl stop home-assistant@homeassistant
sudo systemctl disable home-assistant@homeassistant
Затем удалите файл службы из /etc/systemd/system/, выполните sudo systemctl daemon-reload и сотрите каталоги: виртуальное окружение (обычно /srv/homeassistant) и конфигурацию (/home/homeassistant/.homeassistant). Пользователя homeassistant можно удалить командой sudo userdel homeassistant вместе с домашним каталогом.
⚠️ Внимание: если пользователь homeassistant добавлялся в группыdialoutилиgpioдля работы Zigbee/Z-Wave-стиков, после удаления проверьте, не используются ли эти права другими сервисами.
Что делать с Zigbee/Z-Wave стиками и интеграциями
USB-стики (Zigbee, Z-Wave, Bluetooth) физически отключите от устройства, если они больше не нужны. Сетевые интеграции (MQTT-брокер, Zigbee2MQTT в отдельных контейнерах) удаляйте отдельно — они не являются частью Home Assistant. Если стик планируется использовать с другой системой, сброс координатора обычно не требуется, но привязанные устройства придётся сопрягать заново.
Шаг 7. Финальная проверка остатков
После удаления убедитесь, что система чиста. Проверьте открытые порты — порт 8123 не должен прослушиваться: выполните ss -tlnp | grep 8123. Команда docker ps -a не должна показывать контейнеры homeassistant или hassio.
Дополнительно осмотрите роутер: удалите DHCP-резервирование и правила проброса портов, созданные для Home Assistant, иначе они останутся мёртвыми записями. Если использовался DuckDNS, Nabu Casa или другой внешний доступ — отключите подписку и удалённые туннели.
- 🔍 Проверьте, что порт 8123 свободен.
- 🐳 Убедитесь в отсутствии контейнеров и образов HA.
- 🌐 Очистите проброс портов и DNS-записи в роутере.
- ☁️ Отвяжите облачные сервисы и подписки.
Частые вопросы
Можно ли удалить Home Assistant без потери настроек на будущее?
Да. Создайте полную резервную копию через веб-интерфейс и скачайте архив. При повторной установке — даже другого типа — выберите восстановление из копии на этапе первоначальной настройки.
Удалил контейнер, но папка с конфигурацией осталась — это нормально?
Да, так задумано: Docker не трогает примонтированные тома при удалении контейнера. Папку с конфигурацией нужно удалить вручную, либо сохранить её как архив настроек.
Как удалить Home Assistant с Raspberry Pi полностью?
Если использовалась Home Assistant OS, извлеките SD-карту и отформатируйте её на компьютере. Если установка была поверх Raspberry Pi OS через Docker или venv — следуйте соответствующему разделу этой инструкции.
Нужно ли отвязывать устройства умного дома перед удалением?
Не обязательно: Zigbee- и Z-Wave-устройства привязаны к координатору (стику), а Wi-Fi-устройства — к облаку производителя или локальному приложению. Но если планируете переход на другую систему, сопряжение придётся выполнять заново.
Что делать, если после удаления Supervised система работает нестабильно?
Проверьте оставшиеся службы: systemctl list-units | grep hassio. Удалите найденные юниты, пакет os-agent и каталоги hassio, затем перезагрузите хост. Если проблемы сохраняются, сверьтесь с документацией установщика вашей версии.