Первый запуск

Свежая установка открывается мастером, а не пустым экраном. Мастер проходит четыре шага, и любой можно отложить: «Позже» ведёт на план, вернуться к настройке можно в любой момент.

С чего начать

• Новая квартира — шаблон на одну, две или три комнаты. Дальше мастер подключает Home Assistant и ставит первую лампу.
• Подключить свой Home Assistant — адрес сервера и токен долгосрочного доступа (Профиль → Безопасность → Токены долгосрочного доступа → Создать токен). После подключения — тот же выбор шаблона.
• У меня приглашение — дом уже настроен на другом устройстве. Снимите QR камерой или наберите код. Набирая код руками, укажите адрес сервера Хомера (http://<адрес>:8730): в QR он уже есть. Владелец, пришедший в дом без плана, попадает на выбор шаблона.
• Дом из файла — план, выгруженный из Хомера или собранный по чертежу (.json, .homer).

Шаблоны квартир

Шаблон	Комнаты	Площадь
Однокомнатная	прихожая, санузел, кухня, комната	38 м²
Двухкомнатная	прихожая, санузел, кухня, спальня, гостиная	55 м²
Трёхкомнатная	прихожая, ванная, туалет, кухня, гостиная, спальня, детская	74 м²

Шаблон — заготовка. Размеры комнат, стены, двери и окна правятся в редакторе плана: Расстановка → Править стены. «Пустой лист» начинает с одного этажа без комнат.

Первая лампа

• Zigbee-лампа — открывает сеть Zigbee: включите новую лампу, она найдётся сама. См. Zigbee.
• Лампа из Home Assistant — список ламп, уже подключённых к HA.
• Виртуальная лампа — если настоящей под рукой нет. Сервер Хомера кладёт в Home Assistant пакет homer_demo_lamp.yaml: шаблонную лампу, которая включается, гаснет и меняет яркость, как живая. Заводит её владелец, серверу нужна раскатка пакетов (HA_PACKAGES_DIR). Убрать — снять лампу с плана и удалить пакет: запросом владельца DELETE /v1/onboard/demo-lamp или инструментом homer_packages в Claude Code.

Подсказки на плане

После мастера план показывает пять подсказок по одной: лампа как кнопка, комнаты, три вида дома, правка, добавление устройств и доступ для семьи. «Пропустить» убирает их сразу.

В веб-версии тот же мастер открывается владельцу или редактору на доме без комнат: шаблон и первая лампа.