как установить home assistant на linux
Linux
Install Home Assistant Operating System
Download the appropriate image
Follow this guide if you already are running a supported virtual machine hypervisor. If you are not familiar with virtual machines we recommend installation Home Assistant OS directly on a Raspberry Pi or an ODROID.
Create the Virtual Machine
Load the appliance image into your virtual machine hypervisor. (Note: You are free to assign as much resources as you wish to the VM, please assign enough based on your add-on needs)
Minimum recommended assignments:
All these can be extended if your usage calls for more resources.
Hypervisor specific configuration
After creation of VM go to “Settings” and “Options” then “Advanced” and select “Firmware type” to “UEFI”.
Start up your Virtual Machine
With the Home Assistant Operating System installed and accessible you can continue with onboarding.
Install Home Assistant Container
These below instructions are for an installation of Home Assistant Container running in your own container environment, which you manage yourself. Any OCI compatible runtime can be used, however this guide will focus on installing it with Docker.
This guide assumes that you already have an operating system setup and a container runtime installed (like Docker).
If you are using Docker then you need to be on at least version 19.03.9, ideally an even higher version, and libseccomp 2.42 or newer.
Platform Installation
Installation with Docker is straightforward. Adjust the following command so that:
/PATH_TO_YOUR_CONFIG points at the folder where you want to store your configuration and run it.
Once the Home Assistant Container is running Home Assistant should be accessible using http:// :8123 (replace with the hostname or IP of the system). You can continue with onboarding.
Restart Home Assistant
If you change the configuration you have to restart the server. To do that you have 3 options.
Docker Compose
In order to use docker-compose you first need to install docker-compose on your system.
As the Docker command becomes more complex, switching to docker-compose can be preferable and support automatically restarting on failure or system restart. Create a docker-compose.yml file:
Start it by running:
Exposing Devices
In order to use Z-Wave, Zigbee or other integrations that require access to devices, you need to map the appropriate device into the container. Ensure the user that is running the container has the correct privileges to access the /dev/tty* file, then add the device mapping to your container instructions:
Optimizations
The Home Assistant Container is using an alternative memory allocation library jemalloc for better memory management and Python runtime speedup.
As jemalloc can cause issues on certain hardware, it can be disabled by passing the environment variable DISABLE_JEMALLOC with any value, for example:
The error message : Unsupported system page size is one known indicator.
Install Home Assistant Core
This guide assumes that you already have an operating system setup and have installed Python 3.8 (including the package python3-dev ) or newer.
Install dependencies
Install the dependencies:
Create an account
Create the virtual environment
First we will create a directory for the installation of Home Assistant Core and change the owner to the homeassistant account.
Next up is to create and change to a virtual environment for Home Assistant Core. This will be done as the homeassistant account.
Once you have installed the required Python package it is now time to install Home Assistant Core!
If this address doesn’t work you may also try http://localhost:8123 or http://X.X.X.X:8123 (replace X.X.X.X with your machines’ IP address).
When you run the hass command for the first time, it will download, install and cache the necessary libraries/dependencies. This procedure may take anywhere between 5 to 10 minutes. During that time, you may get “site cannot be reached” error when accessing the web interface. This will only happen for the first time, and subsequent restarts will be much faster.
Install Home Assistant Supervised
This way of running Home Assistant will require the most of you. It also has strict requirements you need to follow.
Unless you really need this installation type, you should install Home Assistant OS (this can also be a virtual machine), or Home Assistant Container.
Once the Home Assistant Supervised installation is running and Home Assistant accessible you can continue with onboarding.
Установка Home Assistant Supervised на Debian Linux
Есть много разных способов как можно установить Home Assistant (список).
Один из способов — это установка Home Assistant с супервизором на компьютер на котором уже работает Linux. Это официально поддерживаемый способ установки, но нужно очень точно следовать всем рекомендациям. Если что-то сделать не совсем так, то Home Assistant переходит в режим «You are running an unsupported installation.» или даже в «Your installation is running in an unhealthy state», а в этом режиме Home Assistant работает исключительно плохо.
Главное требование — операционная система Linux обязательно должна быть Debian 10 aka Buster. Другие операционные системы не поддерживаются.
Этот способ установки называется «Home Assistant Supervised».
В этом тексте рассказывается как установить Home Assistant на компьютер на котором уже установлена операционная система Debian Linux.
Установка Docker
Первое что нужно сделать — это установить Docker.
Дальше нужно выполнить команду, которая обновит информацию про пакеты и установит компоненты которые нужны для установки и работы докера:
Эта команда работает несколько минут — она скачивает из интернета указанные пакеты и устанавливает их на систему.
Дальше нужно запустить команду которая добавит нужный ключ в систему:
Результат команда должна быть строчка «OK».
Следующее действие — нужно добавить добавить в систему новый репозиторий в котором находятся пакеты докера:
(команда должна отработать практически мгновенно, ничего на экран не выведет)
А дальше нужно запустить команду которая обновит информацию про пакеты и установит докер:
После того как эта команда отработала можно проверить что докер успешно установлен с помощью команды
На экране должна появиться строчка которая начинается с «CONTAINER ID»:
Установка дополнительного софта
В режиме суперпользователя нужно выполнить команду:
Это установит программы. Если это не сделать, то при установке Home Assistant будет ошибка вида:
Установка Home Assistant
Это нужно делать в режиме суперпользователя.
Сначала нужно скачать файл в котором прописаны команды для установки:
А дальше нужно запустить этот файл:
Программа задаст вопрос
Нужно на клавиатуре нажать клавишу «y» и нажать Enter.
Установка происходит несколько минут. Вот что показывается на экране после успешной установки:
После этого можно зайти браузером на указанный адрес (в моем случае это был http://192.168.31.93:8123 )
Сразу после установки будет показываться ошибка (в фоне происходит скачивание и установка нужных частей Home Assistant), но если зайти на эту же страницу через несколько минут, то будет уже текст «Preparing Home Assistant»:
А еще через несколько минут появится окно первичной настройки Home Assistant.
На этом установка Home Assistant завершена.
Проблемы при установке
Если вы поставили все нужные пакеты, но все равно при запуске установки получаете ошибку:
Устанавливаем Home Assistant на Ubuntu server
Home Assistant мощная платформа управления глупым умным домом, которая может контролировать и управлять устройствами нашего дома. Работает на большом количестве систем, в том числе Raspberry PI, для которой имеет сборку образ Hass.io. Проект активно развивается и имеет большое сообщество, всю актуальную информацию можно найти на сайте проекта: https://www.home-assistant.io/.
Прежде чем ставить на обычный компьютер я опробовал сборку Hass.io для одноплатника, но у меня она не прижилась, все плюсы системы были перечеркнуты минусами:
Исходя из этого было принято решение установить Home Assistant на нормальный компьютер, точнее в отдельную KVM виртуалку. Ubuntu была выбрана в качестве основной системы т.к. Raspberry Pi OS, так же, как и Ubuntu имеют общие корни Debian.
Установка Home Assistant
Вся предоставленная ниже информация взята на сайте проекта и основана на установке Home Assistant для Raspberry Pi.
Подключаемся к системе, на которой у нас будет крутиться Home Assistant по SSH и обновляем систему до актуального состояния.
После обновления системы устанавливаем необходимые компоненты и зависимости.
Далее создаем папку для ядра Home Assistant и устанавливаем пользователя homeassistant для неё владельцем.
После активации виртуальной среды выполняем установку необходимого пакета Python.
По завершении установки пакета Python приступаем к установке Home Assistant.
Первый запуск может занимать 5-10 минут, после чего проверяем доступность установленной системы через браузер.
http://ha_ip_address:8123
Прерываем работу запущенной системы.
Создаем файл для запуска сервиса при старте системы.
Проверяем работу сервиса.
Через Web браузер проверяем работу Home Assistant.
http://ha_ip_address:8123
Обновление Home Assistant
Для обновления до последней версии необходимо выполнить следующие три команды.
После обновления выполняем перезапуск службы homeassistant@homeassistant.service
Обратите внимание, что первый запуск после обновления может занять некоторое время.
Способы установки Home Assistant
Первая сложность с которой сталкиваются люди при работе с Home Assistant — как его поставить. Есть очень много способов установки системы.
С точки зрения использования системы все способы установки можно разбить на две группы:
Супервизор — это необязательная часть системы. Можно использовать Home Assistant и без супервизора.
Если есть супервизор, то в Home Assistant появляются дополнительные возможности:
Есть сайт с официльной статистикой использования Home Assistant — https://analytics.home-assistant.io.
Вот статистика разных типов установок с этого сайта (скриншот сохранен 17 мая 2021 года):
Home Assistant OS — установка на хост
Это официально рекомендованный способ установки. Установка очень быстрая и простая. Устанавливается Home Assistant вместе с супервизором.
Очень часто этот способ используют для того чтобы установить Home Assistant на Raspberry Pi.
Нужно скачать специальный файл. Этот файл — это образ в котором находится не только Home Assistant, но еще и операционная система.
Вот несколько популярных образов:
Полный список всех образов находится на GitHub.
Этот образ нужно залить на sd карту (в случае Raspberry Pi) или на жесткий диск (в случае Nuc).
Для заливки образа на sd карту очень удобно использовать бесплатную программу balenaEtcher (ссылка — https://www.balena.io/etcher/). Есть версии этой программы под Windows, macOS и Linux.
После того как образ залит на носитель, нужно подключить его к компьютеру, включить компьютер и через некоторое время вы получаете работающий Home Assistant.
У этого способа установки есть особенность — вы получаете «черный ящик» Home Assistant полностью работает, но доступ к операционной системе на которой он работает очень ограничен.
Home Assistant OS — установка в виртуальную машину
Официальный способ установки. Устанавливается Home Assistant вместе с супервизором.
С помощью этого способа можно получить работющий Home Assistant на компьютере с Windows, macOs или Linux. На компьютере появляется вирутальная машина в которой работает Home Assistant.
Нужно сказчать файл с образом с GitHub.
А дальше из этого образа нужно создать виртуальную машину. Это можно сделать, например с помощью VirtualBox.
Home Assistant Supervised
Это официальный способ установки. Но разработчики Home Assistant не особо любят его рекомендовать. Устанавливается Home Assistant вместе с супервизором.
Это возможность установить Home Assistant на компьютер с Linux. Этот способ подходит людям кто знает и умеет использовать Linux консоль. При таком способе установки остается полный доступ к операционной системе, но так же появляется Home Assistant с супервизором.
Опасность этого способа установки — нужно очень точно следовать всем рекомендациям. Если что-то сделать не совсем так, то Home Assistant переходит в режим «You are running an unsupported installation.» или даже в «Your installation is running in an unhealthy state», а в этом режиме Home Assistant работает исключительно плохо.
Главное требование — операционная система Linux обязательно должна быть Debian 10 aka Buster. Другие версии Linux официально не поддерживаются. Поддержка отсутствет даже для тех Linux дистрибутивов которые сильно похожи на Debian (например, Rasbperry OS, Ubuntu).
Прямо сейчас этот способ установки работает и на других операционных системах (Rasbperry OS, Ubuntu), но использование этих операционных систем выдает предупреждение «You are running an unsupported installation.» и, возможно, что в будущем это будет выдавать не только предупреждение, но и вызывать какие-то проблемы с работой. Так что скорее всего, если ставить Home Assistant этим способом, то стоит соблюдать все требования, или использовать другой способ установки.
Home Assistant Container
Это официальный способ запуска Home Assistant. При использовании этого способа супервизора нет.
Для этого способа нужно чтобы на машине был установлен докер. Этот способ можно использовать на любой операционной системе (Windows, macOS, Linux).
Это просто запуск докер контейнера из официального докерного образа Home Assistant. Можно запускать контейнер как напрямую через docker, можно через docker-compose, а можно использовать какие-то другие способы.
Самый простой способ для запуска HA этим способом — это одна команда:
Home Assistant Core
HassWP
Это неофицильный способ установки. Супервизора тут нет. Это возможность запустить Home Assistant на Windows машине очень быстро и просто, и сразу с некоторым наборо предустановленных дополенний.
Установка Home Assistant на нетбуки и старые ПК
Нетбуки были бы идеальным железом для установки сервера Home Assistant, если бы разработчики продолжали поддержку таких систем. Как выяснилось, существует масса нюансов.
В процессе экспериментов, тестировались Ubuntu 16.04, 18.04 (более поздние уже 64-битные), FreeBSD (таки сложная для меня) и Debian 10.8. Далее будет описана установка Home Assistant Supervised на Ubuntu 18.04 LTS и установка в виртуальное окружение на Debian 10.8.
Установка Debian 10.8
Простота процесса установки Debian позволяет в нескольких картинках показать практически все. Пробежимся бегло.
С установкой закончили. Если я что-то и попустил, то все достаточно понятно и задокументировано.
Установка Home Assistant в виртуальное окружение
Курим, пьем кофе, откинувшись на спинку кресла. Много курим.
Теперь устанавливаем Home Assistant и сразу редактор конфигураций YAML:
Переходим по адресу, который указан в конце установки, и ждем (довольно долго) пока Home Assistant закончит установку, после чего появится начальное приветствие.
Пока можно ничего не вводить и продолжить установку дополнительных инструментов.
Скачиваем и устанавливаем HACS. Дальнейшая настройка уже в системе:
Ставим базу MariaDB:
Добавляем в базу таблицу, пользователя и устанавливаем права:
Теперь было бы неплохо сразу изменить конфигурационный файл, добавив подключение к базе, ссылку на редактор YAML и некоторые полезные датчики:
Создаем сервис автозапуска для редактора YAML:
Также нужен сервис для самого Home Assistant:
Теперь можно перезагрузить систему и начать настройку.
Итак, у нас установлен актуальный Home Assistant на актуальной операционной системе, установлен редактор конфигурационных файлов YAML, репозиторий кастомных интеграций HACS и SQL база MariaDB.
Обновление Home Assistant в виртуальном окружении
Установка Ubuntu 18.04 LTS и Home Assistant Supervised
Эта версия Ubuntu еще позволяет установить ее на 32х битную систему, правда с небольшой хитростью. Просто в релизе вы не найдете нужного образа. Но так же, как и для Debian, существует минимальный образ 18.04 LTS. Он занимает всего 68 мбайт.
Качаем, записываем на флешку любимой программой для записи образов, вставляем в свой ПК и устанавливаем в BIOS загрузку с USB.
После установки системы и перезагрузки, советую сразу подключаться с помощью терминальной программы (я все еще пользуюсь putty) и можно приступать к установке Home Assistant.
Подготавливаем и устанавливает Docker и Home Assistant:
Заключение
Или просто залить образ HassOS для NUC, особенно если сетевая карта Intel.
на 32битный процессор? неужели получилось?))
очень интересно с точки зрения проделанной работы, а вот практический смысл какой? Да и где найти такой настолько древний ПК до корковой эпохи. Коркам то уже 10+ лет.
в принципе, я рассчитывал на атомы. их немало еще осталось
Да как бы атомы тоже в основном 64 разряда, а те что 32 достаточно редкие. На кромен n-к.
первые атомы, на которых были первые нетбуки все 32 бита. у меня в загашнике пылилось asus eee pc, acer aspire one d250, ZOTAC ZBOX ID41 и пара fit-pc2
теперь fit-pc2 в деле
Вопрос поссле установки получаю такое
что я делаю не так
все так, на скорость не влияет). просто супервайзер хочет debian 10. кстати, если загрузка процессора в простое будет более 20-30%, можно попробовать поставить этот аддон
хочется иметь актуальную систему, но с убунтой можно только максимум 18.04, а в debian 10 тянется 18й docker, с которым ha не работает((
сейчас тестирую debian 11. пока все нравится, но неподдерживаемый способ установки тоже присутствует т.к. релиза debian 11 еще не было
Было бы неплохо небольшой мануал как сделать все тоже самое но используя Wi-Fi устройства.
Например у меня не везде можно установить девайс и подключить шнурком.
А так сложил нетбук под кровать положил и пусть себе трудится.
Если не сложно то подскажите. А то в линуксах слаб и не получается поставить ХА на нетбуке подключенном по Wi-Fi
После
[info] Replacing /etc/network/interfaces
[info] Restarting NetworkManager
Я теряю связь с сервером и установка НА не продолжается
не уверен, но попробуй поискать сервер на другом ip и с другим macом (поискать на роутере). установка, на самом деле, может продолжаться и через 10-20-30-60 мин может быть закончена (если не прерывать)
нужно будет попробовать самому
Я нахожу сервер на другом ИПе но вот почему то подключиться не могу даже по SSH
по «новому ip»:8123 через время есть что-то?
постараюсь попробовать, но сначала я «добью» тестовую инсталляцию (пытаюсь получить звук из аудиовыхода с управлением из ha)
Посмотрите в сторону аддона Mopidy
бьюсь и c Mopidy и с MPD и с VLC(( если бы еще понимать что делаешь))))))
знакомо.
а вот с этим скриптом установки под убунту у меня не срослось, и тоже не пойму почему. при запуске по инструкции из-под суперпользователя при скачивании образа скрипт выдаёт invalid reference format, под обычным юзером ващще вылетает без ошибок, как так и надо.
Автор! Рад за тебя, что хоть с установкой у тебя всё прошло норм =)
и под убунту и под debian 11 замечательно ставится.
пишите сразу в телегу, попробуем вместе разобраться
как я и думал, дело было не в бобине, просто хард от возраста захряс =)
что интересно, на acer aspire one d257 и на ubuntu 20.04 по той же инструкции поднялся hass.io, без проблем. Образ, такой же минимальный, брал тут:
http://archive.ubuntu.com/ubun.
у меня сейчас умирает в тестовой машине compact flash 16Gb в переходнике на sata) примерно через сутки тупит и виснет. потом еще больше извращусь и поставлю в этот переходник ibm microdrive 6Gb в формате CF)))))))))))
с Atom N570, который 64 битный, проблем не должно быть при любом способе установки. чтобы не ругался на неподдерживаемый способ установки можно поставить debian 10 64 битный. но если душа больше лежит к убунте, то все будет и так прекрасно работать
прискорбно, но вторая часть статьи уже не актуальна(
ругается на pip но свежая версия не совместима с ассистентом