Перейти к основному контенту

Развертывание ядра Home Assistant в Docker


Инструкция по установке локального центра автоматизации и мониторинга Home Assistant Core на сервере Lenovo (Debian) в среде Docker Compose.

Шаг 1. Подготовка дискового пространства

Все конфигурационные файлы, база данных SQLite и логи умного дома будут храниться локально в отдельной директории пользователя.

Выполните команды в терминале сервера для создания структуры папок:

# Переходим в рабочую директорию пользователя
cd /home/stan/

# Создаем корневую папку проекта и поддиректорию для конфигурации
mkdir -p homeassistant/config

# Переходим в созданный проект
cd homeassistant

Текущая структура проекта:

  • /home/stan/homeassistant/ — корневая папка (место хранения docker-compose.yml).
  • /home/stan/homeassistant/config/ — рабочая папка контейнера (карты конфигурации, логи, БД).

Шаг 2. Конфигурация Docker Compose

Для управления контейнером используется стек docker-compose. Настройка сети в режиме host необходима для корректного автообнаружения устройств (mDNS/UPnP) в локальной сети.

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

nano docker-compose.yml

Вставьте следующее содержимое:

version: '3.8'

services:
  homeassistant:
    container_name: homeassistant
    image: "ghcr.io/home-assistant/home-assistant:stable"
    volumes:
      # Монтирование локальной папки конфигурации внутрь контейнера
      - ./config:/config
      # Синхронизация системного времени сервера с контейнером (Read-Only)
      - /etc/localtime:/etc/localtime:ro
    restart: unless-stopped
    # host-режим сети обязателен для локального сканирования сети и интеграций
    network_mode: host

Для сохранения файла в nano нажмите: Ctrl+O → Enter → Ctrl+X.

Шаг 3. Инициализация и запуск

Запустите сборку и деплой контейнера в фоновом режиме:

docker compose up -d

Движок Docker загрузит актуальный стабильный образ Home Assistant и развернет конфигурационную структуру. Первичная初始化 базы данных в папке config/ занимает около 1–2 минут.

Шаг 4. Первичная настройка (Первый запуск)

После успешного запуска веб-интерфейс станет доступен в локальной сети.

  • Адрес веб-панели: http://<IP_АДРЕС_СЕРВЕРА>:8123

Регламент первого запуска:

  1. Создание учетной записи: Задайте имя администратора и надежный пароль.
  2. Геолокация: Точно укажите координаты (п. Ильинский). Это необходимо для работы астрономических триггеров (расчет времени заката, рассвета и фаз луны) и точной погодной сводки.
  3. Первичное сканирование: HA автоматически обнаружит доступные сетевые устройства в локальной сети (роутер, Smart TV, сетевые принтеры и т.д.).


Наверх