Файлы установки https www home assistant io hassio installation
Обновлено: 01.07.2024
Установка операционной системы на сервер еще не делает его сервером умного дома. Для этого необходимо установить специальное программное обеспечение. В моем случае это был Home assistant.
Зайдя на сайт проекта, где я хотел найти документацию, по установке впал в ступор.
Сейчас на сайте проекта в разделе “Установка” перечислено два рекомендованных и три альтернативных способа установки.
Целых 5 разных способов установки, каждая со своими нюансами, достоинствами и недостатками. Давайте разберемся вкратце, что они из себя представляют и какой метод подойдет именно вам.
Рекомендованные методы:
- Home assistant. Для использования этого метода установки вам нужна raspberry pi или виртуальная машина (Доступны образы формата VMDK, VHDX, VDI, QCOW2, OVA). Раньше этот метод назывался hassos, что означает home assistant operation system. Этот образ при установке на наш одноплатник заменит собой установленную ранее операционную систему. Это один из самых стабильных и простых способов установки, рекомендуемый абсолютно всем. Минус данного способа только один - вы теряете контроль над операционной системой, так как она закрыта и существенно урезана по сравнению с обычным linux. Зато нет ничего лишнего и все работает действительно стабильно. Если вы не планируете на вашем сервере запускать какие-либо другие приложения (мультимедия сервер, например), то этот способ вам отлично подходит.
- Docker. Для использования этого способа вам необходимо иметь установленный Docker - программное обеспечение для автоматизации развёртывания и управления приложениями в средах с поддержкой контейнеризации . Если вы уже используете Docker, можно рассматривать этот способ, если нет - идем дальше.
Альтернативные методы:
- Venv (as another user). Установка программного обеспечения в виртуальную среду python, исполняется из под отдельно созданного пользователя. Рекомендуется для опытных пользователей linux.
- Venv (as your user). Тоже самое, что и предыдущий способ, только не создается отдельный пользователь. Рекомендуется только для разработчиков.
- Supervised. Способ для опытных пользователей linux и docker. Представляет собой установку Home Assistant в Docker вместе с компонентом Supervisor, который управляет всей операционной системой HA (на момент написания статьи этот способ находится в подвешенном состоянии, разработчики планировали отказаться от поддержки данного способа установки, но комьюнити подняла шум, и решение все еще функционирует).
Ключевое отличие для конечного пользователя всех этих методов заключается во владке Supervisor, которая позволяет устанавливать аддоны из встроенного маркета, делать снапшоты (бэкапы) системы и настроек, обновлять HA нажатием одной кнопки.
Для новых пользователей я рекомендую самый первый способ - готовый образ Home Assistant. Если бы у меня была возможность установить его на виртуальную машину, то использовал бы его. Но raspberry pi не поддерживает работу с виртуальными машинами. Поэтому я выбрал Supervised, несмотря на то, что я не был знаком с Docker и практически все пришлось изучать с нуля.
Сам я изначально остановился на установке venv, но через пару дней переустановил все на Home Assistant Supervisor. Почему это сделал? Во время настройки интеграции шлюза Xiaomi второй версии с HA возникла ошибка, также ошибка возникала после установки аддона File Editor (тогда он назывался еще Configurator) и я подумал, что я что-то сделал не так. Когда увидел видео, как легко установить File Editor из меню Hassio (так ранее называлась вкладка Supervisor) - решил попробовать эту версию HA, вдруг ошибка c интеграцией шлюза xiaomi устраняется так же легко. Если бы не мое заблуждение, возможно, до сих пор бы сидел на venv и был бы доволен. С интеграцией шлюза xiaomi проблем не было, все делал правильно, проблема была в самом шлюзе.
Т ак как на странице установки доступен официальны образ hassio для виртуальных машин, заметку удалось сильно сократить и теперь она содержит только инструкции по установке официального vdi образа.
В результате мы должны получить работающий Home Assistant, доступный по выделенному IP адресу в домашней сети или даже через интернет, если захочется.
- Home Assistant (HA) - быстро развивающаяся система домашней автоматизации, написанная на языке Python, с огромным списком поддерживаемого оборудования и сервисов
- Гостевая машина - виртуальная Linux машина с Home Assistant
- Хост - физический компьютер с Microsoft Windows (или другой ОС), на которой установлен VirtualBox
- Hass.io - набор docker контейнеров, позволяющий упростить установку и эксплуатацию HA, а также позволяющий расширить его функции с помощью большого количества готовых Hass.io аддонов, поддерживаемых коммьюнити.
Варианты установки Home Assistant:
- Установка Home Assistant в виде python приложения в окружение virtualenv (для тех, кому по каким-то причинам не подходит docker)
- Установка официального образа Home Assistant в контейнер на собственном docker-е (для тех, кто считает, что они сделают собственную копию Hass.io лучше, чем огромное комьюнити опытных разработчиков)
- Установка Hass.io в виде образа SD карты для Raspberry Pi. Ранее этот образ был построен на базе ResinOS, которая недавно была заменена новой операционной системой HassOS, специально оптимизированной для запуска Hass.io (официально рекомендуется для установки на Raspberry Pi)
- Установка Hass.io из готового образа виртуальной машины (ниже мы подробно опишем этот способ)
Новые скриншоты, добавленные в статью, сделаны с MacOS версии VirtualBox, так как Windows машины сейчас под рукой нет, но всё должно работать в обеих операционных системах.
Шаг 1: Устанавливаем VirtualBox и подключаем образ
Создаём виртуальную машину в VirtualBox, количество памяти указываем по вкусу, для улучшения проворности лучше указать 4 или 8 гигабайт, если есть возможность. В качестве типа ОС нужно указать Linux 64bit
В свойствах виртуальной машины в настройках жесткого диска указываем скачанный образ:
Шаг 2: Настраиваем виртуальную машину
Работа напрямую с гостевой машиной в окне VirtualBox неудобна как минимум по двум причинам:
- Невозможно открыть UI Home Assistant в браузере на хосте
- Неудобно работать в консоли гостевой машины с терминалом
Чтобы сделать её доступной в домашней сети, поменяем тип сетевого адаптера в гостевой машине с NAT на Bridged Adapter:
Также зайдём в раздел System и включим поддержку EFI (Enable EFI). Без этой настройки виртуальная машина не будет загружаться с нашего диска:
Шаг 3: Проверяем работу
Если хост-машина не очень быстрая, появление стартовой страницы может занять какое-то время.
Шаг 4: Использование командной строки Hass.io
Через консоль виртуальной машины можно также запустить утилиту командной строки hassio. Надо понимать, что это не полноценный доступ к операционной системе, а лишь набор утилит hassio, доступный из докер-контейнера.
Для входа откроем консоль виртуальной машины, если она была недавно запущена, подождём минуту для очистки совести, а потом нажмём Enter. Нас должна встретить радушная надпись:
Вводим root в качестве имени пользователя и оказываемся в оболочке командной строки hassio.
Здесь можно, например, ввести команду help , чтобы получить список доступных опций или отредактировать файл конфигурации Home Asisstant введя следующую команду:
Краткое описание:
Система домашней автоматизации Home Assistant.
Описание:
Home Assistant-это open-source платформа для автоматизации, работающая на Python 3. Позволяет отслеживать и контролировать все устройства в доме и автоматизировать действия. Идеально может работать на одноплатном компьютере Raspberry PI. Так же может работать на платформах Windows, Linux. Интерфейс построен через браузер работа возможно на любом устройстве Android, iOS.
Личный опыт:
Свою домашнюю систему я строю на данной платформе. Уже больше полугода система находится в штатном режиме и все функционирует.
Не получается настроить присутствие устройств (членов семьи). Использую компонент device_tracker: Keenetic NDMS2 Routers (У меня Zyxel keenetic lite с прошивкой NDMS 2). Ошибка при загрузке в логе (home-assistant.log):
Denn1982, Приложи файл конфигурации посмотрю что делаешь ни так. У тебя тут жалуется еще на плагин yahoo_finance. В своем случае я настроил с помощью SNMP модуля. HA SNMP
Да не знаю, что тут можно делать не так.
Все как в мануале:
- platform: keenetic_ndms2
host: !secret router_ip
username: !secret router_username
password: !secret router_password
хост в секретах: 192.168.1.1
Еще тут одна проблема нарисовалась, после некоторого времени невозможно подключиться по ssh к апельсинке, причем HASS работает, но например некоторые выключатели не работают.
device_tracker:- platform: keenetic_ndms2
host: !secret router_ip
username: !secret router_username
password: !secret router_password
interval_seconds: 10
consider_home: 180
track_new_devices: yes
Так же смотри после запуска в папке появится known_devices.yaml в нем тоже нужно настроить устройства которые будешь отслеживать. Вот мой пример одного из устройств.
bhughes_nexus6:
name: Phone
mac: AC:CF:85:D4:2B:93
icon: mdi:ninja
track: yes
hide_if_away: no В том то и дело, что файл не появляется автоматически, я его пробовал в ручную создавать, но тоже не прокатило. Еще интересно, что когда вставляю эти строчки в configuration.yaml, судя по логу еще и розетки не может найти, хотя в HASS они работают.
А если удалить секцию device_tracker то лог чистый.
UPD: Не, наврал - с розетками все время такая фигня.
В этом посте я покажу вам, как установить HASS.io на Docker в системах Ubuntu или Debian. Я пользуюсь Home Assistant для своих нужд домашней автоматизации с декабря 2017 года, когда я начал свой путь по домашней автоматизации. Home Assistant – это программа на базе Python для автоматизации умного дома с интеграцией более 1000 компонентов. Ранее мы рассмотрели список лучших контроллеров домашней автоматизации, но ни один из них не приблизился к гибкости Home Assistant. К сожалению, гибкость также означает крутой кривой обучения для начинающих.
11 июня 2020 года. Похоже, что сотрудники Home Assistant внесли довольно много изменений за последние несколько месяцев. Во-первых, больше нет HASS.io. Описанный здесь метод подпадает под новое имя «Home Assistant Supervised». Однако установка Home Assistant Supervised в Docker теперь является “неофициальным” методом и не будет поддерживаться людьми Home Assistant. Следовательно, есть
удален скрипт установки HASSio, используемый / связанный в этом посте. Надеюсь, член сообщества заберет его и постоянно обновляет. Но в этот момент мы (включая меня) остались на мели. Пожалуйста, подожди, пока я не найду подходящий метод.
Есть много способов установить Home Assistant. Я начал с HASS.io на Raspberry Pi 3, но быстро понял, что он слишком слабый. Затем попробовал Home Assistant в виртуальной среде Python и, наконец, остановился на Home Assistant в Docker из-за его простоты / мобильности. Как следует из названия, недавно я решил перейти от Home Assistant на Docker к HASS.io на Docker на Ubuntu Server по причинам, подробно описанным ниже.
Домашний Помощник – Умный Дом Хаб
HASS.io на Raspberry Pi – самая распространенная установка. Но я хотел использовать преимущества HASS.io (перечислены ниже) без ограничений оборудования Raspberry Pi. Я решил написать это руководство для людей, которые находятся в моей ситуации. [ Читайте: что такое умный дом и что может сделать умная домашняя автоматизация для вас? ]
Домашний помощник против HASS.io
Во-первых, вы можете спросить, я уже запускаю Home Assistant или Home Assistant на Docker. Почему я хочу перейти на HASS.io? HASS.io – это более автономный домашний помощник, который гораздо проще для начинающих устанавливать и запускать. Home Assistant и HASS.io имеют открытый исходный код, но HASS.io оптимизирован для встраиваемых устройств, таких как Raspberry Pi. Они оба предлагают локальную домашнюю автоматизацию, а не полагаются на облачные сервисы.
Вот несколько уникальных преимуществ HASS.io:
- Простые обновления из веб-интерфейса
- Простое резервное копирование и восстановление
- Многочисленные официальные и общественные дополнения, которые расширяют функциональность домашнего помощника всего за несколько кликов. Автономная установка Home Assistant не предлагает магазина дополнений.
HASS.io Addon Store
Хотя для некоторых это может показаться не таким уж большим, представьте, что вам нужно поддерживать отдельные приложения или контейнеры для докеров для всех ваших нужд домашней автоматизации (например, Home Assitant, MQTT Broker, NodeRed, LetsEncrypt, Dynamic DNS и многое другое). Потратив буквально 100 часов на мой Docker Media Server с обратным прокси- сервером Traefik, я могу вам сказать, что со временем это может потребовать больших усилий. Кроме того, полное голосовое имя домена с SSL необходимо для голосовых помощников (например, Google Assistant) для работы с домашним помощником. [ Читать: Настройка Google Assistant для Home Assistant: Платные и бесплатные опции ]
Home Assistant имеет тенденцию ломать вещи во время обновлений (потому что он быстро развивается). Если вам не нравится, что есть аддон для вас на HASS.io. Он проверяет, совместима ли новая версия с вашими текущими настройками. Затем вы можете решить обновить или отложить его на потом, в зависимости от вашей ситуации.
Я хорошо, чтобы обновить с Home Assistant 0,91,3 до 0,91,4
Некоторые могут возразить, что Home Assistant в Docker лучше, чем HASS.io в Docker, и что Dockerized HASS.io может быть весьма ограничивающим фактором. Чтобы быть ясным, ограничение заключается не в самом домашнем помощнике, а в уровне управления или прямого вмешательства, который позволяет HASS.io. Если вы уже хорошо знаете Docker, почти все, что HASS.io делает с аддонами, можно реплицировать на любой хост с Docker. Но вы хотите или у вас есть время, чтобы сделать это? По моему опыту, большинство пользователей по достоинству оценят упрощенное управление всеми приложениями домашней автоматизации с использованием интерфейса дополнений HASS.io. Это сэкономит вам массу времени, и вы сможете сосредоточиться на домашней автоматизации, а не на обслуживании системы домашней автоматизации. Кроме того, с Portainer, который является веб-интерфейсом для управления докерными контейнерами (доступно как аддон HASS.io), вы можете легко управлять любым аддоном HASS.io, когда это (редко) необходимо.
Я управляю как аддонами HASS.io, так и другими приложениями Docker, с помощью Portainer
Все еще не определились? Ознакомьтесь с этой веткой Reddit, чтобы узнать, что думают некоторые пользователи.
Если вы уверены, тогда давайте посмотрим, как установить HASS.io на Docker в Linux (системы на основе Debian / Ubuntu).
Установите HASS.io на Docker
Существует несколько способов установить HASS.io, наиболее распространенным из которых является установка Raspberry Pi. Но, как я уже говорил, довольно скоро вы поймете, что Raspberry Pi будет недостаточно мощным, если ваша установка будет расти. Даже на моем сетевом хранилище AMD 5350 Ubuntu Server я обнаружил, что Home Assistant работает медленно. Это основная причина, по которой я перешел на NUC для автоматизации дома и нужд Docker.
В этом руководстве я покажу вам, как установить HASS.io на Docker в Linux Mint 19. Но это должно работать на любых системах Debian / Ubuntu. Требуется немного работы командной строки.
Предпосылки
Сначала установите общедоступную версию Docker, как описано в моем руководстве по Docker Media Server. Как только это будет сделано, установите другие необходимые пакеты с помощью следующей команды.
После этого давайте перейдем к установке HASS.io на Docker.
Настройте HASS.io на Docker
Это простая часть, сотрудники Home Assistant написали скрипт для упрощения настройки HASS.io в Docker. Хотя поддерживается практически любое оборудование, некоторые устройства (например, Intel NUC, Odroid и т.д.) Оптимизировали сборки home assistant. Поэтому определите поддерживаемый тип оборудования на странице скрипта GitHub.
Затем выполните следующие команды для настройки HASS.io в Docker в Linux:
Настройка:
все после – необязательно.
- -m intel-nuc – замените тип вашей машины или уберите эту опцию.
- -d / home / user / docker / hassio – Необязательно, но я настоятельно рекомендую вам указать известный путь для хранения данных HASS.io. Путь, указанный здесь, является лишь примером.
После успешного выполнения сценария установки HASS.io Docker выходные данные должны выглядеть примерно так, как показано ниже.
После нескольких минут запуска Home Assistant (первое время может быть медленным), перейдите по следующему URL-адресу:
DOCKER-HOST-IP – это локальный IP-адрес системы Linux, на которой работает Docker. Вы должны перейти на страницу создания учетной записи Home Assistant, показанную ниже.
Создать аккаунт Home Assistant
Обратите внимание, что если у вас уже был или у вас был предыдущий экземпляр home assistant, работающий через порт 8123 в вашей системе, вам придется остановить его. В противном случае HASS.io не запустится из-за конфликта портов.
Теперь вы можете приступить к настройке, автоматизации и приводить людей в безрассудство, когда что-то перестает работать.
Переместить конфигурацию Home Assistant на HASS.io
Что делать, если у вас уже работает домашний помощник, и вы хотите перейти к этим настройкам. Конечно, вы можете сделать это. Если у вас уже есть Lovelace в качестве конфигурации Home Assistant (конфигурация по умолчанию после версии 0.86), то этот шаг довольно прост. Прежде чем продолжить, остановите ваш предыдущий инстанс помощника по дому и HASS.io.
Остановка HASS.io может быть сложной, потому что супервизор HASS.io автоматически запустит ее. Поэтому сначала вам нужно остановить супервизор HASS.io, используя следующую команду:
Затем остановите Home Assistant через веб-интерфейс Конфигурация -> Общие. Затем скопируйте все содержимое из Home помощник папки конфигурации вашего старого экземпляра в homeassistant папки в данном HASS.io папки определенно ранее в процессе установки.
Для переноса устройств Zwave убедитесь, что zwcfg * .xml также скопирован. HASS.io автоматически делает любые USB-флешки Zwave доступными для домашнего помощника. Убедитесь, что путь к USB-устройству совпадает со старыми настройками (например, / dev / ttyACM0). Ваши устройства и конфигурации Z-wave должны мигрировать без проблем. Вы можете проверить эту тему, если у вас есть какие-либо проблемы с Zwave. Просто убедитесь, что ваш предыдущий экземпляр остановлен.
Наконец, запустите супервизор HASSio:
Удаление HASS.io на Docker
Что делать, если что-то идет не так, и вы хотите удалить HASS.io. Это довольно раздражает из-за супервизора HASS.io, который продолжает запуск Home Assistant и его дополнений. Вот как я удалил домашний помощник во время тестирования:
Во-первых, остановите HASS.io Supervisor.
Затем выполните следующие команды:
Теперь вы можете удалить HASSio Supervisor, Home Assistant и аддоны, используя Portainer (если он работает на Docker (я так делаю), но не как Home Assistant Addon) или используя команду rm контейнера docker и имена контейнеров. [ Читать: Как добавить анимированный метеорологический радар в Home Assistant? ]
Читайте также: