Первая загрузка Home Assistant OS без Ethernet: CLI not starting

Home Assistant OS при первой загрузке ожидает проводное подключение к сети. На старом ноутбуке без порта Ethernet загрузка остановилась на предупреждении [WARN] Home Assistant CLI not starting! Jump into emergency console и аварийной консоли (emergency console). На новом HA Green порт 8123 не открывал веб-интерфейс, хотя причина там названа иная. Обычно помогает кабель Ethernet или USB-to-Ethernet адаптер; реже выручают Wi-Fi конфигурация с флешки CONFIG и полная очистка диска данных.

Как выглядит проблема

Проблема отмечена на трех типах устройств, и проявления различаются:

  • старый ноутбук без порта Ethernet: первая загрузка останавливается на предупреждении CLI (интерфейса командной строки) и аварийной консоли;
  • Raspberry Pi 3 Model A+ без порта Ethernet: в ветке спрашивали, как установить на него HAOS;
  • новый HA Green: Observer (служба наблюдения Home Assistant OS) отвечает на порту 4357, но порт 8123 отклоняет подключение, и приложение Home Assistant устройство не находит.

Тексты ошибок из веток форума:

[WARN] Home Assistant CLI not starting! Jump into emergency console
[WARN] Home Assistant CLI not starting! Jump into emergency console...
/bin/ash: network: not found
unknown error, see supervisor

Первые две строки - одно и то же предупреждение, записанное по-разному.

Причины

Явно названа одна причина (в 1 ветке из 3) - отсутствие проводной сети при первой загрузке. Второй сценарий касается уже собранной системы и остается предположением участников форума.

ПричинаКак проверитьЧто сделать
Нет проводного подключения при первой загрузке: у устройства нет порта Ethernet (подтверждено в ветке форума)На устройстве нет разъема Ethernet; загрузка заканчивается предупреждением CLI и аварийной консольюПодключить кабель напрямую или через USB-to-Ethernet адаптер
Контейнер Home Assistant core не запущен, хотя ОС и сеть работают (предположение)Observer отвечает на порту 4357, а подключение к порту 8123 отклоняетсяОбновить ОС (ha os update), запустить ремонт Supervisor, управляющего компонента (ha su repair) и очистить диск данных (ha os datadisk wipe)

Что помогает

Сработали пять способов, каждый по одному отчету.

Ethernet через USB-адаптер

Подключение кабелем - требование документации установки: нужно подключить Ethernet-кабель и убедиться, что Raspberry Pi находится в той же сети, что и компьютер. Про USB-to-Ethernet адаптеры документация не упоминает. Помогло в 1 ветке форума из 2, где его пробовали; итог второй ветки неизвестен.

Вход в оболочку из аварийной консоли

Опыт одного пользователя: в приглашении ha ввод login открыл оболочку (shell). Способ описан только на форуме, в документации его нет.

Загрузка вне металлического корпуса

У одного пользователя загрузка прошла после того, как он достал плату из металлического корпуса и снова включил устройство. Объяснения, почему это сработало, в ветке нет, но отчет об успехе есть.

Wi-Fi с флешки CONFIG

Файлы конфигурации Wi-Fi кладут на флешку FAT32 с именем CONFIG и подключают флешку при запуске. Способ обсуждался в ветке об установке HAOS на Raspberry Pi без Ethernet и сработал у одного пользователя.

Обновление ОС, ремонт и очистка диска

Связка из трех шагов закрыла ветку про новый HA Green: обновление ОС, ремонт Supervisor и очистка диска данных. Помогло в единственной ветке, где это пробовали. Очистка подтверждается документацией, а ha su repair и сам этап ремонта Supervisor в документации не описаны. Очистке нужно дать завершиться, не прерывая процесс.

ha os update
ha su repair
ha os datadisk wipe

Если само обновление не ставится, на сайте есть отдельный разбор про случай, когда обновление Home Assistant падает и откатывается.

Если не помогло

Четыре способа из веток не сработали, по одному отчету в каждом случае:

  • переход по ссылкам на ветки о настройке Wi-Fi, которые приводили участники обсуждения;
  • задание Wi-Fi в расширенных параметрах Raspberry Pi Imager перед записью образа;
  • статический IP-адрес и режим pass-through на модеме Starlink;
  • пересборка контейнера core и перезагрузка хоста из CLI:
ha core rebuild
ha core restart
ha host reboot

Без подтверждений остались еще два предложения: записать файлы Wi-Fi в boot-раздел и поставить обычную Raspberry Pi OS, а затем Home Assistant в варианте Supervised.

Частые вопросы

Можно ли поставить HAOS без Ethernet-порта?

Судя по веткам, да: вопрос возникал для Raspberry Pi 3 Model A+ и ноутбука без порта Ethernet. Рабочие варианты из веток - USB-to-Ethernet адаптер и Wi-Fi конфигурация с флешки CONFIG, но в каждом случае результат подтвердил один пользователь. Документация установки на Raspberry Pi при этом описывает подключение кабелем. Общий порядок установки описан в гайде по установке Home Assistant.

Что означает доступный порт 4357?

Порт 4357 обслуживает Observer, службу наблюдения Home Assistant OS. Если он отвечает, а порт 8123 отклоняет подключения, по предположению участников форума сеть и ОС работают, а контейнер core не запущен. Именно так выглядела ситуация с новым HA Green в одной из веток: Observer был доступен, а веб-интерфейс и приложение устройство не находили.

Что удаляет команда очистки диска данных?

Все пользовательские данные, Home Assistant Core, Supervisor и установленные приложения - это подтверждено документацией. Команда рассчитана на полный сброс, поэтому запускайте ее, только когда данные не нужны или их еще нет. После запуска дайте очистке завершиться: в ветке форума результат появился, когда процессу дали закончиться.

Wi-Fi из Raspberry Pi Imager не сработал - что делать?

Попробуйте флешку CONFIG: этот способ сработал у пользователя, которому не помогли настройки из Imager. Запись тех же файлов Wi-Fi в boot-раздел предлагалась как альтернатива, но подтверждений ей нет. Если Wi-Fi так и не поднимается, посмотрите разбор про Wi-Fi-адаптер в Home Assistant OS на x86.

Стоит ли ставить Supervised вместо HAOS?

Это обходной путь без подтверждений. В одной ветке форума предлагали поставить обычную Raspberry Pi OS и затем Home Assistant в варианте Supervised (установка поверх обычной ОС), но сообщений об успехе нет. Перед таким шагом проще закрыть вопрос с сетью: кабельное подключение описано в документации, а USB-to-Ethernet адаптер помог в 1 ветке из 2.

Андрей Ковалев, редактор. Собирает решения из веток форума Home Assistant и сверяет команды и настройки с официальной документацией.