Установка HA на компьютер с Ubuntu 20

Актуально на момент выхода статьи.

Устанавливаем "голую" серверную систему с ssh.

После установки обновляем, перезагружаем.

Для упрощения, сразу входим с правами суперпользователя (админом).

sudo su

Последняя стабильная версия HA (Home Assistant) 2025.2.5, которая требует минимально Python 3.13

В дистрибутиве Ubuntu 20 более младшая версия, которая нам не подходит.

Добавляем репозиторий:

add-apt-repository ppa:deadsnakes/ppa

на запрос ENTER, просто нажимаем Enter

Устанавливаем Python 3.13 и некоторые требуемые компоненты

sudo apt-get install -y python3.13 python3.13-dev python3.13-venv python3-pip bluez libffi-dev libssl-dev libjpeg-dev zlib1g-dev autoconf build-essential libopenjp2-7 libturbojpeg0-dev tzdata ffmpeg liblapack3 liblapack-dev libatlas-base-dev libtiff-dev libtiff-tools

Создаем нового системного пользователя с домашней папкой для запуска и работы HA, назовем его homeassistant. Добавим его в группу dialout для взаимодействия с устройствами Z-Wave и ZigBee.

sudo useradd -rm homeassistant -G dialout

Cоздаем папку для сервера HA, устанавливаем пользователя homeassistant её владельцем

cd /srv
sudo mkdir homeassistant
sudo chown homeassistant:homeassistant /srv/homeassistant

Создаем виртуальное окружение для HA для пользователя homeassistant

sudo -u homeassistant -H -s
cd /srv/homeassistant
python3.13 -m venv .
source bin/activate

После активации виртуальной среды выполняем установку необходимого пакета Python.

python3.13 -m pip install wheel

Если появится предупреждение что pip можно обновить

[notice] A new release of pip is available: 24.3.1 -> 25.0.1
[notice] To update, run: pip install --upgrade pip
 

Обновляем

pip install --upgrade pip

Устанавливаем последнюю стабильную версию НА

pip3 install homeassistant==2025.2.5

Запускаем HA. Первый запуск долгий, может длится несколько минут, в домашнем каталоге пользователя homeassistant (/home/homeassistant) будет создана папка .homeassistant, в которой будут находится конфигурационные файлы системы.

hass

Как только сервер развернется, он будет доступен по http://ha_ip_address:8123

Прерываем работу запущенной системы.

Ctrl+C

Выходим из учетной записи пользователя homeassistant.

exit

Делаем автозапуск НА при старте системы.

создаем файл homeassistant.service

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

копируем в него:

[Unit]
Description=Home Assistant
After=network-online.target

[Service]
Type=simple
User=homeassistant
WorkingDirectory=/home/homeassistant/.homeassistant
ExecStart=/srv/homeassistant/bin/hass -c "/home/homeassistant/.homeassistant"
RestartForceExitStatus=100

[Install]
WantedBy=multi-user.target