Файлы установки https www home assistant io hassio installation
Есть много разных способов как можно установить 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.
Выяснить ip адрес
Выяснить ip адрес виртуальной машины можно либо с помощью веб интерфейса роутера, либо выполнив несколько команд в консоли виртуальной машины.
На приглашение "homeassistant login:" нужно ввести слово "root" и нажать на клавишу Enter на клавиатуре. После этого вы сразу попадете в консоль Home Assistant.
В этой консоли нужно ввести слово "login":
И после этого ввести "nmcli" — в результате на экране будет виден ip адрес этой виртуальной машины:
В моем случае это адрес 192.168.31.170
Hypervisor specific configuration
- Create a new virtual machine
- Select Type “Linux” and Version “Linux 2.6 / 3.x / 4.x (64-bit)”
- Select “Use an existing virtual hard disk file”, select the unzipped VDI file from above
- Edit the “Settings” of the VM and go “System” then “Motherboard” and select “Enable EFI”
- Then go to “Network” “Adapter 1” choose “Bridged Adapter” and choose your Network adapter
- Then go to “Audio” and choose “Intel HD Audio” as Audio Controller.
By default VirtualBox does not free up unused disk space. To automatically shrink the vdi disk image the discard option must be enabled:
- Create a new virtual machine in virt-manager
- Select “Import existing disk image”, provide the path to the QCOW2 image above
- Choose “Generic Default” for the operating system
- Check the box for “Customize configuration before install”
- Select your bridge under “Network Selection”
- Under customization select “Overview” -> “Firmware” -> “UEFI x86_64: …”
- Click “Add Hardware” (bottom left), and select “Channel”
- Select device type: “unix”
- Select name: “org.qemu.guest_agent.0”
- Finally select “Begin Instalation” (upper left corner)
- Create a new virtual machine
- Select “Custom”, make it compatible with the default of Workstation and ESX
- Choose “I will install the operating system later”, select “Linux” -> “Other Linux 5.x or later kernel 64-bit”
- Select “Use Bridged Networking”
- Select “Use an existing virtual disk” and select the VMDK file above,
After creation of VM go to “Settings” and “Options” then “Advanced” and select “Firmware type” to “UEFI”.
- Create a new virtual machine
- Select “Generation 2”
- Select “Connection -> “Your Virtual Switch that is bridged”
- Select “Use an existing virtual hard disk” and select the VHDX file from above
After creation go to “Settings” -> “Security” and deselect “Enable Secure Boot”.
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 будет ошибка вида:
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 activated the virtual environment (notice the prompt change to (homeassistant) [email protected]:/srv/homeassistant $ ) you will need to run the following command to install a required Python package.
Once you have installed the required Python package, it is now time to install Home Assistant Core!
Start Home Assistant Core for the first time. This will complete the installation for you, automatically creating the .homeassistant configuration directory in the /home/homeassistant directory, and installing any basic dependencies.
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.
Follow this guide if you want to get started with Home Assistant easily or if you have little to no Linux experience.
This guide assumes that you have a dedicated generic x86 PC (typically an Intel or AMD-based system) available to exclusively run Home Assistant Operating System. The system must be 64-bit capable and able to boot using UEFI. Pretty much all systems produced in the last 10 years support the UEFI boot mode.
You will need to write the HAOS (Home Assistant OS) disk image directly to your boot media, and configure your x86 to use UEFI boot mode when booting from this media.
Configure the BIOS on your x86-64 hardware
To boot Home Assistant OS, the BIOS needs to have UEFI boot mode enabled and Secure Boot disabled. The following screenshots are from a 7th generation Intel NUC system. The BIOS menu will likely look different on your systems. However, the options should still be present and named similarly.
To enter the BIOS, start up your x86-64 hardware and repeatedly press the F2 key (on some systems this might be Del , F1 or F10 ).
Make sure the UEFI Boot mode is enabled.
Disable Secure Boot.
Save the changes and exit.
As a next step, we need to write the Home Assistant Operating System image to the target boot medium. The HAOS has no integrated installer. This means the Operating System is not copied automatically to the internal disk.
- The “boot medium” is the medium your x86-64 hardware will boot from when it is running Home Assistant.
- Typically, an internal medium is used for the x86-64 hardware. Examples of internal media are S-ATA hard disk, S-ATA SSD, M.2 SSD, or a non-removable eMMC.
- Alternatively, an external medium can be used to boot HAOS such as a USB SDD (not recommended).
To install the HAOS internally on your x86-64 hardware, there are 2 methods:
- Copying the HAOS disk image from your Desktop computer onto your boot medium (e.g. by using a USB to S-ATA adapter). This is not an option for a non-removable eMMC on your x86-64 hardware, of course. To use this method, follow the steps described in the procedure below: Write the image to your boot media.
- Copying a live operating system (e.g. Ubuntu) onto a USB device. Then, insert this USB device into your x86-64 hardware and start the Ubuntu.
- To use this method, follow the instructions of your Live distribution (e.g., this Ubuntu guide). Once you booted the live operating system, follow the steps described in the procedure below: Write the image to your boot media.
Проблемы при установке
Если вы поставили все нужные пакеты, но все равно при запуске установки получаете ошибку:
Это значит что вы неправильно перешли в режим суперпользователя. Например, вы использовали команду "su", вместо правильной "su -". (технические подробности — при использовании "su" в $PATH не добавляется путь /sbin в котором лежит программа apparmor_parser)
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.
Home Assistant Core
Start up your Generic x86-64
- If you used your desktop system to write the HAOS your boot media, install the boot media (storage device) in the generic-x86-64 system.
- If you used a live operating system (e.g. Ubuntu), shut down the live operating system and make sure to remove the USB flash drive you used for the live system.
Make sure an Ethernet cable is plugged in for network.
Power the system on.
- Wait for the Home Assistant welcome banner to show up in the console of the generic-x86-64 system.
In the browser of your Desktop system, within a few minutes you will be able to reach your new Home Assistant on homeassistant.local:8123.
With the Home Assistant Operating System installed and accessible you can continue with onboarding.
Установить на компьютер VirtualBox
Нужно зайти на страницу https://www.home-assistant.io/hassio/installation/ и скачать с этой страницы файл по ссылке "VMDK".
Размер файла — около 300 мегабайт.
У файла который скачался расширение ".vmdk.gz". Это архив. Нужно разархивировать этот файл.
Home Assistant OS — установка в виртуальную машину
Официальный способ установки. Устанавливается Home Assistant вместе с супервизором.
С помощью этого способа можно получить работющий Home Assistant на компьютере с Windows, macOs или Linux. На компьютере появляется вирутальная машина в которой работает Home Assistant.
Нужно сказчать файл с образом с GitHub.
А дальше из этого образа нужно создать виртуальную машину. Это можно сделать, например с помощью VirtualBox.
Start up your Virtual Machine
With the Home Assistant Operating System installed and accessible you can continue with onboarding.
Установка Docker
Первое что нужно сделать — это установить Docker.
Для этого нужно перейти в режим суперпользователя (для этого нужно набрать команду 'su -' в консоли и ввести пароль).
Дальше нужно выполнить команду, которая обновит информацию про пакеты и установит компоненты которые нужны для установки и работы докера:
Эта команда работает несколько минут — она скачивает из интернета указанные пакеты и устанавливает их на систему.
Дальше нужно запустить команду которая добавит нужный ключ в систему:
Результат команда должна быть строчка "OK".
Следующее действие — нужно добавить добавить в систему новый репозиторий в котором находятся пакеты докера:
(команда должна отработать практически мгновенно, ничего на экран не выведет)
А дальше нужно запустить команду которая обновит информацию про пакеты и установит докер:
После того как эта команда отработала можно проверить что докер успешно установлен с помощью команды
На экране должна появиться строчка которая начинается с "CONTAINER ID":
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.
HassWP
Это неофицильный способ установки. Супервизора тут нет. Это возможность запустить Home Assistant на Windows машине очень быстро и просто, и сразу с некоторым наборо предустановленных дополенний.
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.
Есть много разных способов как можно установить Home Assistant.
Какой способ использовать — зависит от ситуации. В разных ситуациях разные способы предпочтительны.
Один из способов как можно установить Home Assistant — это использовать бесплатную программу VirtualBox. На компьютере появляется виртуальная машина в которой работает Home Assistant.
Большой плюс этого способа в том что нужно выполнить очень мало действий для того чтобы получить работающий Home Assistant. На мой взгляд, это самый простой и быстрый способ установки. Результат — вы получаете Home Assistant, который установлен официальным способом, в котором работает Supervisor. (специальный компонент, с помощью которого удобно управлять некоторыми частями Home Assistant. Не во всех способах установки он доступен.)
Установка Home Assistant в VirtualBox хорошо подходит в ситуациях:
- Вы еще не работали с Home Assistant и хотите поэкспериментировать с ним без необходимости покупать отдельный компьютер специально для Home Assistant
- У вас уже есть работающий сервер Home Assistant, но вы хотите поднять тестовый сервер на котором проводить всякие опыты.
Этот способ нельзя использовать для того чтобы поставить Home Assistant на Raspberry Pi.
Запуск в VirtualBox это, скорее, экспериментальный запуск, хотя могут быть и исключения. Можно держать основной сервер Home Assistant в VirtualBox, но обычно так не делают.
Установка Home Assistant в VirtualBox состоит из следующих частей:
- установить на компьютер VirtualBox
- скачать файл с образом Home Assistant
- создать виртуальная машину
- запустить виртуальную машину
- выяснить ip адрес
- зайти браузером в интерфейс Home Assistant
Install Home Assistant Core
Create an account
Add an account for Home Assistant Core called homeassistant . Since this account is only for running Home Assistant Core the extra arguments of -rm is added to create a system account and create a home directory.
Install dependencies
Before you start, make sure your system is fully updated, all packages in this guide are installed with apt , if your OS does not have that, look for alternatives.
Install the dependencies:
The above-listed dependencies might differ or missing, depending on your system or personal use of Home Assistant.
Install WSL
To install Home Assistant Core on Windows, you will need to use the Windows Subsystem for Linux (WSL). Follow the WSL installation instructions and install Ubuntu from the Windows Store.
As an alternative, Home Assistant OS can be installed in a Linux guest VM. Running Home Assistant Core directly on Windows is not supported.
This is an advanced installation process, and some steps might differ on your system. Considering the nature of this installation type, we assume you can handle subtle differences between this document and the system configuration you are using. When in doubt, please consider one of the other installation methods, as they might be a better fit instead.
This guide assumes that you already have an operating system setup and have installed Python 3.9 (including the package python3-dev ) or newer.
Home Assistant OS — установка на хост
Это официально рекомендованный способ установки. Установка очень быстрая и простая. Устанавливается Home Assistant вместе с супервизором.
Очень часто этот способ используют для того чтобы установить Home Assistant на Raspberry Pi.
Нужно скачать специальный файл. Этот файл — это образ в котором находится не только Home Assistant, но еще и операционная система.
Вот несколько популярных образов:
Полный список всех образов находится на GitHub.
Этот образ нужно залить на sd карту (в случае Raspberry Pi) или на жесткий диск (в случае Nuc).
После того как образ залит на носитель, нужно подключить его к компьютеру, включить компьютер и через некоторое время вы получаете работающий Home Assistant.
У этого способа установки есть особенность — вы получаете "черный ящик" Home Assistant полностью работает, но доступ к операционной системе на которой он работает очень ограничен.
Home Assistant Container
Это официальный способ запуска Home Assistant. При использовании этого способа супервизора нет.
Для этого способа нужно чтобы на машине был установлен докер. Этот способ можно использовать на любой операционной системе (Windows, macOS, Linux).
Это просто запуск докер контейнера из официального докерного образа Home Assistant. Можно запускать контейнер как напрямую через docker, можно через docker-compose, а можно использовать какие-то другие способы.
Самый простой способ для запуска HA этим способом — это одна команда:
Write the image to your boot media
Attach the Home Assistant boot media (storage device) to your computer
Download and start Balena Etcher. (You may need to run it with administrator privileges on Windows).
Select “Flash from URL”
Get the URL for your Generic x86-64:
Select and copy the URL or use the “copy” button that appear when you hover it.
Установка Home Assistant
Это нужно делать в режиме суперпользователя.
Сначала нужно скачать файл в котором прописаны команды для установки:
А дальше нужно запустить этот файл:
Программа задаст вопрос
Нужно на клавиатуре нажать клавишу "y" и нажать Enter.
Установка происходит несколько минут. Вот что показывается на экране после успешной установки:
Сразу после установки будет показываться ошибка (в фоне происходит скачивание и установка нужных частей Home Assistant), но если зайти на эту же страницу через несколько минут, то будет уже текст "Preparing Home Assistant":
А еще через несколько минут появится окно первичной настройки Home Assistant.
На этом установка Home Assistant завершена.
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.
Запустить виртуальную машину
Очень быстро система загрузится и на экране будет текст "homeassistant login:" (возможно понадобится несколько раз нажать на клавишу Enter на клавиатуре чтобы стал виден этот текст).
Все — Home Assistant работает. Но нужно выяснить адрес где он работает.
Зайти браузером в интерфейс Home Assistant
После того как известен ip адрес можно браузером зайти в интерфейс Home Assistant.
Дальше нужно придумать имя и пароль и начинается самое интереснео — настройка Home Assistant.
Первая сложность с которой сталкиваются люди при работе с Home Assistant — как его поставить. Есть очень много способов установки системы.
С точки зрения использования системы все способы установки можно разбить на две группы:
- Где есть супервизор (supervisor)
- Где нет супервизора
Супервизор — это необязательная часть системы. Можно использовать Home Assistant и без супервизора.
Если есть супервизор, то в Home Assistant появляются дополнительные возможности:
- Можно "в один клик" устанавливать разные дополнения
- Появляется простая возможность делать бекапы системы
- Супервизор проверяет что система работает корректно, например уведомляет если заканчивается место
- Появляются дополнительные сервисы hassio.*
Вот статистика разных типов установок с этого сайта (скриншот сохранен 17 мая 2021 года):
Создать виртуальная машину
Запускаем VirtualBox, там нажимаем кнопку New.
- Name — вводим "ha"
- Type — меняем на "linux"
- В качестве жесткого диска выбираем файл c расширением ".vmdk"
- И нажимаем кнопку "Create"
После этого в VirtualBox появилась виртуальная машина с именем "ha" в статусе "Выключена".
Но перед тем как ее включить нужно выполнить еще несколько настроек.
Нужно зайти в настройки и поставить чекбокс "Enable EFI":
Если чекбокс "Enable EFI" не установить, то при попытке включить виртуальную машину будет ошибка: "FATAL: No bootable medium found! System halted.":
Вторая настройка которую нужно сделать — поменять настройки сети. По умолчанию установлен "NAT", нужно выбрать "Bridged Adapter":
С этой настройкой можно виртуальная машина станет частью вашей локальной сети.
Читайте также: