Установка Home Assistant: полное руководство

Что такое Home Assistant и зачем его устанавливать

Home Assistant (HA) — это открытая система управления умным домом, которая работает полностью локально, без зависимости от облака. Ваши данные остаются дома, устройства управляются даже без интернета, а количество поддерживаемых интеграций превышает 2700 — от умных лампочек до климат-контроллеров и камер наблюдения.

HA распространяется бесплатно под лицензией Apache 2.0. Платить нужно только за железо и, по желанию, за подписку Nabu Casa (~$6.5/мес) для упрощённого удалённого доступа и интеграции с голосовыми помощниками. Подписка необязательна — всё можно настроить бесплатно.

В этой статье — пошаговая инструкция по всем способам установки: от самого простого (HAOS на мини-ПК) до продвинутых (Docker, Supervised на Debian). Выберите свой вариант — и через 15-20 минут у вас будет работающая система умного дома.

Какой способ установки выбрать

Существует четыре основных способа установки Home Assistant. Выбор зависит от ваших навыков, бюджета и железа.

Рекомендация для большинства: HAOS на мини-ПК с Intel N100.

Это надёжное решение, которое не потребует замены 5-7 лет. SSD не деградирует от постоянной записи (в отличие от SD-карты Raspberry Pi), достаточно мощности для любых задач, есть USB-порты для Zigbee-координатора.

Способ 1. Установка HAOS на мини-ПК (рекомендуемый)

Home Assistant Operating System (HAOS) — это специализированная ОС, которая содержит всё необходимое: ядро HA, Supervisor и поддержку Add-ons. Устанавливается на внутренний накопитель мини-ПК за 15-20 минут.

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

• Мини-ПК на Intel N100/N95 (Beelink, Trigkey, MeLe) с 8 ГБ RAM и SSD 128 ГБ
• USB-флешка 8 ГБ или больше
• Ethernet-кабель для подключения к роутеру
• Программа Balena Etcher (для записи образа на флешку)
• Монитор и клавиатура — только для первичной настройки BIOS

Шаг 1. Скачайте образ HAOS

Перейдите на сайт home-assistant.io/installation/ и выберите «Generic x86-64». Скачайте файл с расширением .img.xz (около 800 МБ — 1 ГБ).

Также скачайте Balena Etcher с balena.io/etcher — это бесплатная утилита для записи образов на USB-накопители.

Шаг 2. Запишите образ на флешку

1. Вставьте USB-флешку в компьютер (все данные на ней будут стёрты).

2. Откройте Balena Etcher.

3. Нажмите «Flash from file» и выберите скачанный .img.xz образ HAOS.

4. Нажмите «Select target» и выберите вашу USB-флешку.

5. Нажмите «Flash!» и дождитесь завершения (3-5 минут).

Шаг 3. Настройте BIOS мини-ПК

Подключите монитор и клавиатуру к мини-ПК. Включите его и сразу нажимайте клавишу входа в BIOS (зависит от производителя):

В BIOS измените следующие настройки:

• Boot order: установите USB-флешку первым загрузочным устройством
• Secure Boot: Disabled (HAOS не поддерживает безопасную загрузку)
• Fast Boot: Disabled (чтобы USB-загрузка работала корректно)
• Режим загрузки: UEFI (а не Legacy/CSM)

Сохраните изменения (обычно F10) и выйдите из BIOS.

Шаг 4. Установите HAOS на внутренний диск

Мини-ПК загрузится с USB-флешки. Появится меню загрузчика GRUB с выбором слотов — выберите «Slot A (OK=1 TRY=1)» и нажмите Enter.

Установщик автоматически определит доступные накопители. Если диск один — установка начнётся автоматически. Если несколько — выберите нужный.

Внимание: все данные на выбранном диске будут полностью удалены! Процесс занимает 3-5 минут. Не выключайте питание, даже если кажется, что процесс «завис» — система распаковывает образ и настраивает сервисы.

После завершения система автоматически перезагрузится. В этот момент извлеките USB-флешку, иначе установка начнётся заново.

Шаг 5. Первый запуск

После перезагрузки на экране появится командная строка HAOS с приглашением «Ha >». Через 60-90 секунд система покажет полученный IP-адрес (например, 192.168.1.XXX). Запишите его.

На любом устройстве в той же сети откройте браузер и перейдите по адресу:

http://homeassistant.local:8123

или

http://192.168.1.XXX:8123

Шаг 6. Первичная настройка (Onboarding)

1. Создайте аккаунт владельца: имя пользователя и пароль.

2. Укажите имя дома и адрес — нужно для погодных данных и автоматизаций по восходу/закату.

3. Часовой пояс: Europe/Moscow (или ваш).

4. Аналитика: можно включить или пропустить.

5. HAOS автоматически обнаружит устройства в сети — добавьте нужные интеграции.

Готово! Home Assistant установлен и работает.

Способ 2. Установка HAOS на Raspberry Pi

Классический вариант для знакомства с HA. Raspberry Pi 4 или 5 (минимум 2 ГБ RAM) подойдёт, но помните: SD-карта — слабое место, она выходит из строя через 1-2 года. Решение — использовать SSD через USB-адаптер, но тогда теряется ценовое преимущество перед мини-ПК.

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

• Raspberry Pi 4 или 5 с блоком питания
• MicroSD-карта 32 ГБ (Application Class 2 — для лучшей производительности)
• Кардридер
• Ethernet-кабель

Установка через Raspberry Pi Imager

1. Скачайте и установите Raspberry Pi Imager с raspberrypi.com/software/.

2. Откройте программу, выберите «Other specific-purpose OS» -> «Home automation» -> «Home Assistant».

3. Выберите версию HAOS, соответствующую вашей плате (RPi 4 или RPi 5).

4. Вставьте SD-карту и выберите её как накопитель.

5. Нажмите «Next» -> «Write» и дождитесь записи.

6. Извлеките SD-карту, вставьте в Raspberry Pi.

7. Подключите Ethernet-кабель и блок питания.

8. Через 1-2 минуты откройте в браузере http://homeassistant.local:8123 (или http://X.X.X.X:8123, где X.X.X.X — IP-адрес Raspberry Pi).

9. Пройдите мастер первичной настройки (как в способе 1).

Способ 3. Установка Home Assistant Container в Docker

Home Assistant Container — это HA, запущенный как Docker-контейнер. Вы получаете ядро HA, но без Supervisor и Add-on Store. Mosquitto, Zigbee2MQTT, Node-RED и бэкапы нужно сопровождать как отдельные контейнеры. Подходит для тех, кто уже использует Docker и хочет встроить HA в существующую инфраструктуру.

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

• Linux-сервер с Docker Engine 23.0.0+ (не Docker Desktop)
• Минимум: 2 CPU, 2 ГБ RAM, 20 ГБ диска
• Базовые навыки работы с командной строкой

Шаг 1. Установите Docker

Если Docker ещё не установлен:

curl -fsSL https://get.docker.com -o get-docker.sh

sudo sh ./get-docker.sh

sudo usermod -aG docker $USER

newgrp docker

Шаг 2. Создайте docker-compose.yaml

Создайте каталог для конфигурации и файл compose.yaml:

mkdir -p ~/homeassistant/config

cd ~/homeassistant

nano compose.yaml

Вставьте содержимое:

services:

  homeassistant:

    container_name: homeassistant

    image: «ghcr.io/home-assistant/home-assistant:stable»

    volumes:

      — ./config:/config

      — /etc/localtime:/etc/localtime:ro

      — /run/dbus:/run/dbus:ro

    restart: unless-stopped

    privileged: true

    network_mode: host

    environment:

      TZ: Europe/Moscow

Важно: network_mode: host обязателен для корректной работы mDNS, обнаружения устройств, HomeKit и Cast. Параметр ports: несовместим с host-сетевым режимом и не должен использоваться.

Шаг 3. Запустите контейнер

docker compose up -d

Дождитесь загрузки образа и инициализации (несколько минут). Откройте в браузере http://IP_ВАШЕГО_СЕРВЕРА:8123 и пройдите мастер настройки.

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

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

docker compose up -d

docker image prune -f

Резервное копирование в Container-режиме

Поскольку Supervisor недоступен, бэкапы делаются вручную: скопируйте каталог ./config на внешнее хранилище. Для автоматизации можно использовать скрипт с tar и cron, или отдельный контейнер с rsync/rclone.

Способ 4. Установка Home Assistant Supervised на Debian

Supervised — это HA с полным Supervisor и Add-on Store, но поверх обычной ОС (только Debian 12 Bookworm). Вы получаете гибкость HAOS, но сами управляете ОС. Метод требует продвинутых навыков Linux. Любые изменения в системе могут привести к статусу «Unsupported».

Предупреждение

С декабря 2025 года Home Assistant объявил о прекращении поддержки Supervised на альтернативных платформах. Установка возможна только на чистый Debian 12 — не на Ubuntu, не на Fedora. Если вы не уверены — выберите HAOS.

Шаг 1. Подготовьте Debian 12

Установите чистый Debian 12 Bookworm (минимальная установка, без GUI).

Обновите систему и установите зависимости:

sudo apt update && sudo apt upgrade -y

sudo apt install -y \

  apparmor jq wget curl udisks2 libglib2.0-bin \

  network-manager dbus lsb-release \

  systemd-journal-remote systemd-resolved

Переключите сеть на NetworkManager (после этого IP-адрес может измениться):

sudo systemctl restart systemd-resolved.service && \

  sudo systemctl disable —now networking.service && \

  sudo mv /etc/network/interfaces /etc/network/interfaces.disabled && \

  sudo systemctl restart NetworkManager

Шаг 2. Установите Docker

curl -fsSL https://get.docker.com | sh

sudo usermod -aG docker $USER

newgrp docker

Шаг 3. Установите OS-Agent

OS-Agent обеспечивает связь Supervisor с операционной системой через D-Bus.

ARCH=$(uname -m)

if [ «$ARCH» = «x86_64» ]; then

  wget https://github.com/home-assistant/os-agent/releases/latest/download/os-agent_linux_amd64.deb

elif [ «$ARCH» = «aarch64» ]; then

  wget https://github.com/home-assistant/os-agent/releases/latest/download/os-agent_linux_aarch64.deb

fi

sudo dpkg -i os-agent_*.deb

sudo systemctl status os-agent

Шаг 4. Установите Home Assistant Supervised

wget https://github.com/home-assistant/supervised-installer/releases/latest/download/homeassistant-supervised.deb

sudo dpkg -i homeassistant-supervised.deb

sudo apt —fix-broken install -y

Во время установки выберите machine type: generic-x86-64. Процесс занимает 10-15 минут. Откройте http://IP_ВАШЕГО_СЕРВЕРА:8123 и дождитесь появления приветственного экрана.

Что делать после установки

1. Создайте первый бэкап

Сразу после настройки аккаунта создайте резервную копию — до добавления устройств. В HAOS и Supervised: Настройки -> Система -> Резервное копирование -> Создать резервную копию. Это позволит откатиться, если что-то пойдёт не так.

2. Установите рекомендуемые Add-ons

• File Editor — Редактирование YAML-конфигов прямо из браузера
• Terminal & SSH — Доступ к командной строке HA по SSH
• Samba share — Доступ к файлам HA из Windows по сети
• Mosquitto broker — MQTT-брокер для умных устройств
• Zigbee2MQTT — Поддержка Zigbee-устройств (альтернатива ZHA)

3. Подключите Zigbee-координатор

Для Zigbee-устройств нужен USB-координатор. Рекомендуемые модели: SONOFF Zigbee 3.0 USB Dongle Plus-E (~$20) или ConBee II. Подключите его в USB-порт (лучше через удлинитель, чтобы избежать помех). В HA: Настройки -> Устройства и службы -> Добавить интеграцию -> ZHA (встроена в HA) или установите Zigbee2MQTT как Add-on.

4. Настройте удалённый доступ

Чтобы управлять домом из интернета, не открывайте HA напрямую — это небезопасно. Три безопасных варианта:

• Nabu Casa — $65/год, работает из коробки, без настройки роутера
• DuckDNS + Let’s Encrypt — бесплатно, Add-on устанавливается одним кликом, настройка 15-20 минут
• VPN (WireGuard/Tailscale) — бесплатно, максимальная безопасность

5. Добавьте первые устройства

Перейдите в Настройки -> Устройства и службы -> Добавить интеграцию. HA автоматически обнаруживает многие устройства в сети. Начните с простого: умные розетки, лампочки, датчики движения.

6. Создайте первые автоматизации

Визуальный редактор: Настройки -> Автоматизации и сцены. Схема простая — триггер + условие + действие.

• Пример «Свет по движению в коридоре»:
•   Триггер: датчик движения сработал
•   Условие: освещённость ниже 30 люкс
•   Действие: включить свет, выключить через 3 минуты

Типичные проблемы и решения

HA не открывается по homeassistant.local:8123

Используйте IP-адрес напрямую: http://192.168.1.XXX:8123. На Windows может потребоваться включить поддержку mDNS. Проверьте, что устройство и HA в одной подсети.

После установки HA долго загружается

Первый запуск может занять 5-10 минут — HA разворачивает базу данных и запускает сервисы. Подождите, не перезагружайте.

Secure Boot блокирует загрузку HAOS

Отключите Secure Boot в BIOS. HAOS не подписан сертификатами Microsoft и не проходит проверку безопасной загрузки.

Контейнер Docker не видит USB-координатор

Пробросьте устройство через —device /dev/ttyUSB0 (или лучше через /dev/serial/by-id/… для стабильного имени).

Supervised показывает «Unsupported»

Не устанавливайте дополнительные пакеты в Debian. Система должна оставаться минимальной. Любые изменения делают установку неподдерживаемой.

SD-карта на Raspberry Pi вышла из строя

Используйте SSD через USB-адаптер или перейдите на мини-ПК. SD-карта — самое ненадёжное хранилище для постоянно работающего сервера.

Чек-лист установки

1. Выберите железо (мини-ПК N100 — оптимально)

2. Скачайте образ HAOS с home-assistant.io

3. Запишите образ на USB-флешку через Balena Etcher

4. Настройте BIOS: USB-загрузка, UEFI, Secure Boot — Disabled

5. Загрузитесь с флешки и установите HAOS на внутренний диск

6. Извлеките флешку при перезагрузке

7. Подключите Ethernet-кабель к роутеру

8. Откройте http://homeassistant.local:8123

9. Создайте аккаунт владельца, укажите часовой пояс

10. Создайте первый бэкап

11. Установите Add-ons: File Editor, Samba, Mosquitto

12. Подключите Zigbee-координатор (USB)

13. Добавьте первые устройства через интеграции

14. Настройте удалённый доступ (DuckDNS или Nabu Casa)

15. Создайте первую автоматизацию

Итог

Home Assistant — мощная и гибкая система, которую можно установить за 15-20 минут. Для большинства пользователей оптимальный путь — HAOS на мини-ПК с Intel N100: надёжно, тихо, энергоэффективно и хватает на годы. Если вы уже работаете с Docker — Container-вариант даст гибкость без Supervisor. А для тех, кто хочет полный контроль над ОС — Supervised на Debian, но с пониманием рисков.

Главное правило: не открывайте HA напрямую в интернет, всегда делайте бэкапы перед обновлениями и не устанавливайте несколько методов одновременно — выберите один.