Home assistant supervisor windows

So I guess you have got here in one of three ways:

1. You have been scanning the home assistant forms, trying to find out how you can run home assistant supervised on Windows and have been presented with, is some very unhelpful and abrupt “NO” responses without actually giving you some helpful information.
2. You just can’t get your hands on a Raspberry Pi 4 to run your Home Assistant supervised installation, but you’ve got some old PC hardware that is gathering dust and now you want to utilise it to run Home Assistant Supervised and are looking for some support.
3. You have found my YouTube Video.

Well if you haven’t found my YouTube Video you can find it here:

The video is a companion to this Step by Step guide and visually covers every step of this process and is designed to run side by side with this so please open it up in a new window and use it the follow along.

Few things before we get into it.  You’re going to need to PC running windows, in my example I’m using windows 10 but windows 11 is also fine.

That PC need to be online and connected to your home network.  

You also need to make sure that virtualisation has been turned on in your computer’s BIOS setting.

There is a detailed Articale over on https://www.simplilearn.com/ that shows you how to do this on Windows 10.

Картинка с сайта: smlp.co.uk

Step 1: Get Your Tools

First, we need to get the tools that we are going to need to get Debian Linux Installed in a VM on Windows.

For these make sure you download the correct version for your computer system.  There is an ARM and AMD/Intel (x64) version of each app.

1.01 Debian: https://www.debian.org

1.02 VirtualBox: https://www.virtualbox.org

1.03 Visual C++: https://learn.microsoft.com/ (Look for the “Visual Studio 2015, 2017, 2019 and 2022 section).

1.04 Once downloaded install “Visual C++” and then “VirtualBox”.  The Debian ISO file is for the next step.

Step 2: Install Debian

Картинка с сайта: smlp.co.uk

2.01 Open “VirtualBox” and select New.

2.02 Give your VM a name: “homeassistant”.

2.03 Select the pulldown on ISO image and select “Other”.

2.04 Select the download Debian ISO – This will be in your download folder.

2.05 Click on “Skip Unattended Installation” this will stop the installation from setting up a desktop environment that we will not be using.

2.06 Set the base memory.  This will work with 2GB however my advice would be to set it to 4GB or more.

2.07 Processors ideally set this to 2 as a minimum.  If you’re not going to use the PC for anything other than Home Assistant I would set this to 75% of what’s available to you.

2.08 The Virtual Hard Disk is where Home Assistant Supervised will keep all files and history.  I Have Rana system for 6 months with only 64GB however I would recommend that you set it to 120GB as a minimum this way you don’t have to change anything later if you run the system for a long time.

2.09 Click “Finish”

2.10 Click “Setting”, and “Network” and change the Network Adaptor from “NAT” to “Bridged Adaptor”

2.11 Click “OK”

2.12 Now Start the VM

Follow the install process inside of the VM window.  

2.13 Hostname is the name of your computer and could be anything: homeassistant

2.14 For Domain Name if you are already using this in your home set this as you normally would, if not then you can make one or just press return to skip: ha.home

2.15 Your root password and user password should be different.   

2.16 The user name I’m using here is “smlp” you will need to change this where needed.

2.17 For the Partitioning method use: “Guided – use entire disk”.

2.18 Select the disk to partition, you should only see one option

2.19 For the Partitioning scheme you can use any option here but I used: “Separate /home partition”.

2.20 Select “Finish partitioning and write changes to disk”.

2.21 Write the changes to disk?: “Yes”

2.22 For Scan extra installation media? Select: “No”.

2.23 For the Debian archive mirror select your country and then the preselected option that shows. In my example: the United Kingdom, deb.debian.org.

2.24 If you are using an HTTP proxy you will already have the information for “HTTP proxy information” if not just press: “Continue”

2.25 Participate in the package usage survey? This is up to you: “Yes” or “No”

2.26 Under software to install:

Deselect “Debian desktop environment”

Deselect “GNOME”

Select “SSH server”

Select “standard system utilities”

2.27 Install the GRUB boot loader to your primary drive?: “Yes”

2.28 Device for boot loader installation: Select the “VBOX” device listed

2.29 Installation complete: Continue

2.30 The VM will now reboot.

Step 3: Get Ready to Install Home Assistant

First, get the IP address for the system.

3.01 Login user your username and password setup in the installation process.

3.02 Get the system IP address:

ip a

Your address will be shown under the “BROADCAST” section, not the “LOOPBACK” section.

My ip shows as: 192.168.1.186/24

Discard the “/24” so my IP is 192.168.1.186

3.03 Now switch to root and install Sudo.  Having this will help with being able to follow along more easily with guides and tutorials from other websites in case you want to do more with the system at a later date. Enter the commands:

su

(Enter your root password setup in the installation process)

3.04 Install sudo

apt install sudo

3.05 Next, we need to add your user “smlp” to be able to use “sudo”.

nano /etc/sudoers

Under the line:

root ALL=(ALL:ALL) ALL

Add the line

smlp ALL=(ALL:ALL) ALL

Remember you will need to change “smlp” to your user name.

Hold “Ctrl X”, and then “Y” to save and return to confirm the file.

Step 4: Install Dependencies and Home Assistant

4.01 In the Windows search bar type CMD and “RETURN” to open the command prompt.

4.02 Now connect via SSH but remember to use your user name and IP address.

ssh [email protected]

Type “yes” to confirm “Fingerprint”

Enter you user password.

4.03 You are now connected to the system via SSH and we are going to use this to install Docker that runs Home Assistant the dependencies that make everything work as well as Home Assistant Supervised.  Simply copy and paste the command into the command prompt in the order listed:

4.04

sudo su -

4.05

apt-get update
apt-get upgrade -y
apt-get dist-upgrade -y

4.06

apt-get install \
apparmor \
jq \
wget \
curl \
udisks2 \
libglib2.0-bin \
network-manager \
dbus \
lsb-release \
systemd-journal-remote -y

4.07

curl -fsSL get.docker.com | sh

4.08 For the following commands, you first need to make sure that version “1.4.1” is the correct and latest version of Home Assistant before entering the command.  You do this by heading over to the Home Assistant Github first to check the listed version number then edit the “1.4.1” to the latest version for the next two commands.

Home Assistant Github: https://github.com/home-assistant/os-agent/releases/

4.09

wget https://github.com/home-assistant/os-agent/releases/latest/download/os-agent_1.4.1_linux_x86_64.deb

4.10

dpkg -i os-agent_1.4.1_linux_x86_64.deb

4.11

wget https://github.com/home-assistant/supervised-installer/releases/latest/download/homeassistant-supervised.deb

4.12

dpkg -i homeassistant-supervised.deb

4.13 Home Assistant Supervised is now installed close down the Virtual Machine Window and select “send the shutdown signal”.

Step 5: Additional Setup

5.01 In the left-hand panel on VirtualBox right click on your VM and select “Create Shortcut on Desktop”

5.02 Now hold down the Windows Key and “R” on the keyboard.

5.03 Enter the command “shell:start” this will open a folder.

5.04 Copy the new VM shortcut on the desktop into the “Start-up” folder, next time Windows starts it will auto-open your new Home Assistant VM.

5.05 If you have a Zigbee USB Dongle like the two listed below you can set these up by plugging them into your Windows PC then in Setting, USB on VirtualBox you can link them to your Home Assistant VM.

Debug Point has an article showing you how to do this: https://www.debugpoint.com/enable-usb-virtualbox/

5.06 Windows Remote Desktop allow you to connect to your Window PC from any other computer or iOS or Android mobile phone via the Remote Desktop App when you are on your home network.  This is not available on Windows Home 10/11.

To set up Remote Desktop click on Windows/Start, Setting and search for Remote Desktop and Enable.

5.07 Also, you can set Windows up so that if it has been restarted or accidentally turned off it will Auto start without the need for entering your Windows username and password when it first boots up.  You can enter your Windows username and password to get VirtualBox going again after a shutdown via Remote Desktop from another computer but if you want to set it without doing this:

Click on Windows/Start, Setting and search “Sign-in option” and change Requires sign-in to “never”

This will not always work but there is a more detailed article on Help Desk Geek on how to do this: https://helpdeskgeek.com

5.08 If you want to keep a copy of your new Home Assistant VM before you fully set it up so that you have a fallback in case something goes wrong you can do this from VirtualBox by right-clicking on your VM and selecting “Clone”.  Remember if you switch to using this Clone you will also need to add a shortcut for it to the windows “Start-up” folder and remove the old one if it’s no longer needed.

Step 6: Home Assistant Supervised

Картинка с сайта: smlp.co.uk

If Everything has gone to plan you are now done.  Start your new Home Assistant VM and wait for it to boot.

6.01 You can now access Home Assistant using your VM’s IP address followed by the Home Assistant Port.  For me this would be:

http://192.168.1.186:8123 

Thank you for taking the time to follow along with my guide.  If you have any feedback or additional pointers please let me know in the comments here or on my YouTube Channel.

If you found it helpful and want to support me you can buy me a coffee on Ko-Fi or just help promote the guides that I am making by sharing this post, liking or subscribing to my video on my Youtube Channel.

Other Links:

Setting up Home Assistant Supervised on Debian: https://mathesonsteplock.ca

Setting up HACS on Home Assistant:  Smart Home Junkie

Уровень сложностиСредний

Время на прочтение8 мин

Количество просмотров50K

Несмотря на огромное количество текстов по установке Home Assistant, решил написать свой.

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

Home Assistant развивается, часть мануалов устарела, часть содержит ошибки, часть написана Очень Умными Парнями, живущими в Линуксе и которые пишут что-то вроде: «сделай три раздела, два для систем и один для хомяка, и при установке систем подключай раздел с хомяком к каждой, только не форматируй его постояннo» (с). Это подлинная цитата, причём одна из самых понятных.

Мой текст написан виндузятником для себя и для людей, которые видят командную строку максимум раз в пару дней и не обязаны помнить все ключи команд линкуса. Описан весь процесс, собранный по многим мануалам. На часть мануалов приведена ссылка.

Итак.

В качестве подопытного был выбран ноутбук Acer Aspire E15. Тупо был. Был куплен бэушным семь лет назад за 10 тыс. рублей для разъездного менеджера по принципу: если потеряет – чтобы было не жалко. То есть, он был изрядно устаревшим уже тогда. Потом лежал на антресолях, всеми забытый. Думаю, в каждой мало-мальской приличной фирме такого хлама найдется с десяток штук и вам его подарят за пару пива знакомому сисадмину. Если нет знакомого сисадмина, то авито в помощь. Все равно в итоге получится в те же деньги или чуть дешевле и лучше, чем приличный одноплатник.  Плюсом вы получите нормальный процессор, жесткий диск вместо вечно умирающей флешки и, если повезёт, не совсем дохлую батарею вместо источника бесперебойного питания.

На моём ноуте был проводной Ethernet, кто-то (возможно даже я) уже позаботился дорастить память до 8Gb вместо 4 и воткнуть древний SATA SSD диск на 256 Gb. Для работы с Windows  так себе, но для моих целей – за глаза.

Способ установки — виртуальная машина на Debian. Попробую объяснить, почему.

1. Немного пояснений

1.1. Почему всё-таки, хоть плохонький, но PC, я объяснил выше. Основное – это желание иметь полноценный жесткий диск. Наличие у ноута своего экрана и клавиатуры – тоже плюс в тех редких случаях, когда удалённый доступ почему-либо невозможен.

1.2. С другой стороны, для одного HA, такой машины, всё таки, жирновато, поэтому хочется, если уж затевать такую пьянку, повесить на него функции домашнего NAS на внешнем диске и DLNA сервера, чтобы смотреть скачанные с торрентов купленные на официальных сервисах кино долгими зимними вечерами. Чуть позже добавится маленький Apache и VPN сервер.

1.3. Можно тупо поставить HASSOS, как операционную систему. Тогда DLNA и NAS можно запустить, как плагины. Я попробовал — мне не понравилось. Во-первых очень заморочная установка, во-вторых нужные мне плагины показались мне довольно кривыми.  В третьих, сама операционка и мои права в ней усечены до крайности.  Для Raspberry пойдет, для полноценного ноута – так себе.

1.4. Можно поставить как контейнер в докере. В таком случае вы автоматически лишаетесь плагинов. Среди них есть очень даже полезные. Можно, конечно, каждый из них ставить отдельными контейнерами. По мне – тот еще гемор.

1.5. Более продвинутый вариант – тот же докер в режиме Supervised. Моя предыдущая установка была именно такая. Плагины работают. Не все, правда, но почти все. Но с какого-то обновления пошли необъяснимые проблемы с совместимостью, перестал обновляться супервизор. Стал рыться – проблема не у меня одного. Возникает спорадически у разных людей. Лечение – полная переустановка. Или «Обновитесь до последней версии». А у меня какая??? Я тебя ставил 10 минут назад. Бесит, короче.

1.6. Ну и чисто эстетически мне перестал нравится docker. Постоянная борьба с логами, которые он пишет в самые затейливые места и тихо засирает диск, проблемы с совместимостью пакетов. Нельзя, как в Windows, поставить пакет, а потом его просто удалить. Обязательно либо остаются хвосты по всему диску, либо удаляемый пакет забирает с собой что-то важное. То есть – штука одноразовая. Короче, после очередного раунда безуспешной борьбы, я решил, что у меня есть более важные занятия в жизни, чем разбираться в докере и его причудах. Память позволяет, диск позволяет, процессор позволяет. Итак: виртуальная машина с HASSOS живёт, никому не мешает и ей никто не мешает. В остальной памяти делаю, что хочу.     

2. Предварительные ласки

2.1. Загружаем образ Debian с официального сайта. Можно любой другой дистрибутив Linux. Лично мне нравится Debian своей незамутненностью. Он не пытается быть похожим на винду, как многие, ибо все равно получается плохо. Такой чистый брутал. Стабильный. Ну и много литературы по нему, конечно. Внимание. Некоторые команды отличаются в разных дистрибутивах. Всё, что написано далее – написано про Debian 12.

2.2. Скачиваем с официального сайта последнюю версию Rufus. Вставляем флешку, все настройки по умолчанию, выбираем только что скачанный образ — делаем загрузочную флешку.

3. Установка

3.1. На ноуте, нажинаем F2 при загрузке, проверяем настройки загрузки. В параметрах должно стоять UEFI, флешка первой в порядке загрузки. Корректируем при необходимости.

3.2. Для некоторых дистрибутивов  (например для HASSOS) требуется отключить безопасную загрузку, но соответствующий пункт меню подсвечен серым и не выбирается. Для того, чтобы его активировать, нужно установить пароль супервизора. После этого выбор режима безопасной загрузки становится активным. К счастью, Debian 12 такого не требует. Оставляем, как есть. Если безопасный режим всё-таки выключен, то ИМХО лучше включить.

3.3. Запускается загрузка. Выбираем установку в графическом режиме. Красноглазые поборники расовой чистоты пингвинов конечно фыркнут, но графический режим чисто визуально приятнее. 

3.4. Выбор языка. Выбираем русский, страну, раскладку клавиатуры, часовой пояс. Далее пароли администратора, имя и пароли пользователя и т.п.

3.5. Сетевые карты установились автоматически, но иногда приходится бежать за драйвером. На этот случай полезно иметь под рукой второй компьютер и еще одну флешку.

3.6. Спрашивает про разметку диска. Я весь диск отдал целиком, с разделами по умолчанию. Переспросила — уверен ли я. Уверен. Все данные на диске уничтожены. Плакать поздно.

3.7. Выбор софта. Я оставляю выбор по умолчанию, оболочку Gnome по причинам, указанным в п.1.1, добавляю к умолчанием еще SSH сервер. После этого можно идти пить чай. Что-то устанавливается сразу, что-то подкачивается из интернета и тоже устанавливается. Процесс небыстрый.

3.8. Перезагрузка. Вынимаем флешку. После перезагрузки нелишне проверить в биосе порядок загрузки.  Правим при необходимости.

4. Настраиваем вход через терминал

4.1. Идем в настройки роутера, ищем нового клиента, в настройках DHCP прописываем ему статический адрес. Передергиваем DHCP, убеждаемся, что ваш компьютер переподключился по новому адресу. Выписываем адрес на листочек, запоминаем.

4.2. Теперь можно заходить на него со своего рабочего компьютера по SSH через PuTTY или что-у-вас-там-вместо-телнета.

4.3. Свой логин и пароль, введенные ранее в п.2.4., надеюсь, помним?

5. Включаем себя в группу sudo

5.1. Заходим под рутом. Другой вариант – заходить под своим логином , далее уходить в root командой su –

usermod  -aG sudo ИмяПользователя

5.2. Возвращаемся обратно

su –  «Имя пользователя»

4.3. Проверяем. Например:

sudo ls -la /root

6. Лично мне иногда удобно пользоваться графическим удаленным рабочим столом. Настраиваем его. Опционально.

5.1. Включаем

sudo apt install xrdp

5.2. В Windows набираем «Подключение к удаленному рабочему столу». Получаем примерно это.

5.3. Вводим адрес из п. 3.1. Подключаемся.

Картинка с сайта: habr.com

7. Убираем засыпание Debian

7.1. Убираем общие засыпания.

sudo systemctl mask sleep.target suspend.target hibernate.target hybrid-sleep.target

7.2. Поскольку у нас ноутбук, нам надо убирать засыпание при закрытии крышки

sudo nano /etc/systemd/logind.conf

7.3. В секции [Login] Находим строчки HandleLidSwitch=  и HandleLidSwitchDocked=

7.4. Ставим ignore

HandleLidSwitch=ignore

HandleLidSwitchDocked=ignore

7.5. Не забываем раскомментировать.

7.6. Сохраняем, выходим,

7.7. Рестарт службы

sudo systemctl restart systemd-logind.service

8. Полезности

8.1 Файл менеджер mc. Опционально. Иногда удобно.

sudo apt install mc

8.2. Пакет управления сетью. Потребуется для следующих шагов.

sudo apt install ethtool

9. Если несмотря на ИБП питание выключилось, а с ним выключился компьютер, полезно иметь возможность разбудить компьютер по сети

9.1. При загрузке, заходим в BIOS. Проверяем в биосе, что WOL включен. Если не включен – включаем.

9.2. Смотрим список сетевых интерфейсов

ip a

9.3. Находим название проводного интерфейса. Обычно это eth0, но бывают варианты. У меня enp3s0

9.4. Делаем временный WOL

sudo ethtool --change enp3s0 wol g

9.5. Проверяем

sudo ethtool enp3s0

9.6. Смотрим вывод. Ищем строчку wake-on: g. Если есть, то всё в порядке.

9.7. Запихиваем это в автозагрузку. Для этого:

9.8. Узнаем путь к ethtool

which ethtool

9.9. Смотрим вывод. У меня оно хранится в /usr/sbin/ethtool

9.10. Создаём файл wol.service в  /etc/systemd/system

sudo nano /etc/systemd/system/wol.service

9.11. В него вписываем:

[Unit]

Description=Enable Wake On Lan

[Service]

Type=oneshot

ExecStart = /usr/sbin/ethtool --change enp3s0 wol g

[Install]

WantedBy=basic.target

9.12. Запускаем службу

sudo systemctl daemon-reload

sudo systemctl enable wol.service

9.13. Проверяем

sudo shutdown

9.14. Будим машину удобным для вас способом. В интерфейсе кинетике для есть специальная кнопочка.

9.15. Если все работает, настраиваем автозапуск будилки на роутере или на другом внешнем устройстве гарантированно запасающемся по сбою питанию. На Keenetic это делается через opkg

10. Устанавливаем виртуальную машину.

(сперта https://g-soft.info/linux/10968/kak-ustanovit-virtualbox-7-0-v-debian/)

10.1. Проверяем зависимости, большая часть уже на месте, те, которых не хватает, устанавливаем.

sudo apt install dirmngr ca-certificates software-properties-common apt-transport-https curl -y

10.2. Необходимо импортировать ключ GPG (GNU Privacy Guard). Ключ GPG является частью системы криптографии с открытым ключом, которая позволяет убедиться в том, что устанавливаемые пакеты являются подлинными и получены из официального репозитория VirtualBox

curl -fSsL https://www.virtualbox.org/download/oracle_vbox_2016.asc | gpg --dearmor | sudo tee /usr/share/keyrings/virtualbox.gpg > /dev/null

10.3. Добавляем репозиторий Virtialbox

echo "deb [arch=$( dpkg --print-architecture ) signed-by=/usr/share/keyrings/virtualbox.gpg] http://download.virtualbox.org/virtualbox/debian $(lsb_release -cs) contrib" | sudo tee /etc/apt/sources.list.d/virtualbox-7.list

10.4. Обновляем список репозиториев

sudo apt update

10.5. Установка Virtual Box

sudo apt install virtualbox-7.0 linux-headers-$(uname -r) -y

10.6. Добавляем пользователя в группу

sudo usermod -aG vboxusers alexl

10.7. Находим значок VirtialBox. Запускаем, проверяем

11. Установка Home assistant.

подсмотрено здесь: https://ivan.bessarabov.ru/blog/how-to-install-home-assistant-in-virtualbox)

11.1. Скачиваем vdi образ с официального сайта https://www.home‑assistant.io/installation/alternative

11.2. Разархивируем

11.3. Открываем виртуальную машину

11.4. На правой панели жмём Создать

11.5. Пишем название (лучше без пробелов)

11.6. Образ ISO оставляем пустым

11.7. Тип: Linux

11.8. Версия: Linux 2.6 / 3.x / 4.x (64-bit).

11.9. Вкладка Оборудование: сколько не жалко, но не менее 2 процессоров и не менее 2GB RAM

11.10. Ставим галку EFI

11.11. Вкладка Жесткий диск: ставим использовать существующий виртуальный диск. Выбираем наш скачанный образ

11.12. Создать машину

11.13. Идем в опции сети. Меняем NAT на bridge

11.14. Запускаем

12. Настройка доступа из сети

12.1. Идем в роутер, видим новое устройство. Это виртуальная машина. Прописываем ей статический адрес

12.2. В настройках роутера прописываем доменное имя на этот адрес и порт 8123

13. Прописываем автозапуск виртуальной машины при перезагрузке.

(https://redos.red-soft.ru/base/arm/os-virtual/virtualbox/virtualbox-autostart/)

13.1. Создаем новую службу

sudo nano /etc/systemd/system/vbox@.service

13.2. Прописываем туда

Description=Virtual Box Guest %I

After=network.target vboxdrv.service

Before=runlevel2.target shutdown.target

[Service]

User=свой юзернайм

Group=vboxusers

Type=forking

Restart=no

TimeoutSec=5min

IgnoreSIGPIPE=no

KillMode=process

GuessMainPID=no

RemainAfterExit=yes

ExecStart=/usr/bin/VBoxManage startvm %i --type headless

ExecStop=/usr/bin/VBoxManage controlvm %i acpipowerbutton

[Install]

WantedBy=multi-user.target

13.3. Реинициализируем службы.

systemctl daemon-reload

13.4. %1 в первой строке – это параметр, куда вставляется имя или идентификатор вашей виртуальной машины. Имя вы знаете из п. 10.5, но идентификатор использовать правильнее. Узнаем его

VBoxManage list vms

13.5. Находим нужную машину, копируем идентификатор, вставляем в следующую команду

sudo systemctl status vbox@идентификатор

13.6. Что‑то вроде:

sudo systemctl status vbox@cea2060b-61a1-44a1-b5df-f9a6b0b82f43

13.7. Если ошибки нет, смотрим статус. После @будет ваш идентификатор.

sudo systemctl status vbox@cea2060b-61a1-44a1-b5df-f9a6b0b82f43

13.8. Если все норм, добавляем в автозагрузку. (идентификатор меняем на свой)

sudo systemctl enable vbox@cea2060b-61a1-44a1-b5df-f9a6b0b82f43

14. Финальная настройка

14.1. Заходим по вашему адресу, например:

http://192.168.0.15:8123

14.2. Или, как у меня

https://Hassio.mydomen.keenetic.pro

14.3. Вводим пароль, логин

14.4. Ждём

14.5. Настраиваем параметры места.

14.6. Пользуемся!