Guide: Installing Home Assistant Core on Ubuntu 22.04

wootje · August 29, 2023, 2:38am

I was logged in as user “root”. If you use another user, first type “sudo -s” or “su” to get root access.

Install Home Assistant Core on Ubuntu 22.04

apt update && apt upgrade
optionally to make sure all packages are installed correctly:
- dpkg --configure -a
- apt install -f
- apt-get --fix-broken install
- apt-get update --fix-missing
- apt update && apt upgrade
add-apt-repository ppa:deadsnakes/ppa
apt update
apt install wget build-essential libncursesw5-dev libssl-dev
libsqlite3-dev tk-dev libgdbm-dev libc6-dev libbz2-dev libffi-dev zlib1g-dev
apt install python3.11 python3.11-dev python3.11-venv python3-pip
Change the first line in files “/usr/bin/pip” & “/usr/bin/pip3” to “#!/usr/bin/python3.11”
apt install bluez libffi-dev libssl-dev libjpeg-dev zlib1g-dev autoconf build-essential libopenjp2-7 libtiff5 libturbojpeg0-dev tzdata ffmpeg liblapack3 liblapack-dev libatlas-base-dev
useradd -rm homeassistant -G dialout
mkdir /srv/homeassistant
chown homeassistant:homeassistant /srv/homeassistant
sudo -u homeassistant -H -s
cd /srv/homeassistant
python3.11 -m venv .
source bin/activate
python3.11 -m pip install wheel
pip3 install homeassistant==2023.8.3
hass
Create file (init.d script) “/etc/init.d/homeassistant”

#!/bin/sh
# For Ubuntu:
# description: Home Assistant
# processname: hass

### BEGIN INIT INFO
# Provides:          hass
# Required-Start:
# Required-Stop:
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# Short-Description: Home Assistant service
# Description:       Home Assistant
### END INIT INFO

name="HomeAssistant"
pid_file="/var/run/$name.pid"

case "$1" in
    start)
		su - homeassistant -c '/srv/homeassistant/bin/python3.11 /srv/homeassistant/bin/hass' &>/dev/null &
		echo $(pgrep python3.11) > "$pid_file"
		echo "Running with PID: $(pgrep python3.11)"
    ;;
    stop)
        echo -n "Stopping $name.."
        kill $(pgrep python3.11)
	rm "/var/run/$name.pid"

    ;;
    restart)
        stop
		start
    ;;
    status)
        if $(pgrep hass); then
            echo "Running with PID: $(pgrep python3.11)"
        else
            echo "$name is not running"
            exit 1
        fi

    ;;
    *)
    echo "Usage: $0 {start|stop|restart|status}"
    exit 1
    ;;
esac
exit 0

chmod 0755 /etc/init.d/homeassistant
update-rc.d homeassistant defaults
reboot
Check if Home Assistant is running:
service homeassistant status
Done
Go to “http:// « ip address » :8123”
Close the session to end root access

Worked for me

IgorZg · August 29, 2023, 5:08am

Hi,
Nice guide, I am sure that it will help someone, but I can’t understand why you not using systemd to start/stop service. This init.d script looks wrong, particulary stop section:

    stop)
        echo -n "Stopping $name.."
        kill $(pgrep python3.11)

will basically kill all running python 3.11 processes.
I am running Home Assistant Core for a long time under Ubuntu 18.04 and now 22.04, plus zigbee2mqtt, zwave-js-ui (zwavejs2mqtt), AppDaemon, Node Red.
Here is my systemd unit just for example:

igor@hass:~$ cat /etc/systemd/system/[email protected]
[Unit] 
Description=Home Assistant
After=network-online.target
After=zigbee2mqtt.service
[Service]
Type=simple
User=%i
ExecStart=/srv/hass311/bin/hass -c "/home/%i/.homeassistant"
Restart=always
StandardOutput=journal
StandardError=journal+console
[Install]
WantedBy=multi-user.target

synogen · October 14, 2023, 1:23pm

Thank you for this guide, it worked for me!

Before step 18 Create file (init.d script) “/etc/init.d/homeassistant” I had to switch back to the root user so I could write to “/etc/init.d/homeassistant” but other than that it went flawlessly and I have been through several other guides before that seemed to leave out a lot of details and never worked, so I am glad I found this.

Teng_Wang · December 10, 2023, 5:16pm

I ran into many errors in Ubuntu 22.04 (Virtualization Station on QNAP):

2023-12-10 09:10:17.239 ERROR (SyncWorker_2) [homeassistant.util.package] Unable to install package aiohue==4.7.0: WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None)) after connection broken by ‘NewConnectionError(’<pip._vendor.urllib3.connection.HTTPSConnection object at 0x7fc385fefe50>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution’)‘: /packages/f0/91/fdde4b2bbfea57856674ebd6168c235d2b69027fc30486f3f7c243b6723a/aiohue-4.7.0-py3-none-any.whl.metadata
WARNING: Retrying (Retry(total=3, connect=None, read=None, redirect=None, status=None)) after connection broken by ‘NewConnectionError(’<pip._vendor.urllib3.connection.HTTPSConnection object at 0x7fc385fe2d50>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution’)‘: /packages/f0/91/fdde4b2bbfea57856674ebd6168c235d2b69027fc30486f3f7c243b6723a/aiohue-4.7.0-py3-none-any.whl.metadata
WARNING: Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by ‘NewConnectionError(’<pip._vendor.urllib3.connection.HTTPSConnection object at 0x7fc385fe4950>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution’)‘: /packages/f0/91/fdde4b2bbfea57856674ebd6168c235d2b69027fc30486f3f7c243b6723a/aiohue-4.7.0-py3-none-any.whl.metadata
WARNING: Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by ‘NewConnectionError(’<pip._vendor.urllib3.connection.HTTPSConnection object at 0x7fc385fe4f50>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution’)‘: /packages/f0/91/fdde4b2bbfea57856674ebd6168c235d2b69027fc30486f3f7c243b6723a/aiohue-4.7.0-py3-none-any.whl.metadata
WARNING: Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by ‘NewConnectionError(’<pip._vendor.urllib3.connection.HTTPSConnection object at 0x7fc385fe5850>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution’)‘: /packages/f0/91/fdde4b2bbfea57856674ebd6168c235d2b69027fc30486f3f7c243b6723a/aiohue-4.7.0-py3-none-any.whl.metadata
ERROR: Could not install packages due to an OSError: HTTPSConnectionPool(host=‘files.pythonhosted.org’, port=443): Max retries exceeded with url: /packages/f0/91/fdde4b2bbfea57856674ebd6168c235d2b69027fc30486f3f7c243b6723a/aiohue-4.7.0-py3-none-any.whl.metadata (Caused by NewConnectionError(’<pip._vendor.urllib3.connection.HTTPSConnection object at 0x7fc385fe6050>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution’))
2023-12-10 09:10:26.945 ERROR (SyncWorker_2) [homeassistant.util.package] Unable to install package aiohue==4.7.0: WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None)) after connection broken by ‘NewConnectionError(’<pip._vendor.urllib3.connection.HTTPSConnection object at 0x7fbbf082a3d0>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution’)‘: /packages/f0/91/fdde4b2bbfea57856674ebd6168c235d2b69027fc30486f3f7c243b6723a/aiohue-4.7.0-py3-none-any.whl.metadata
WARNING: Retrying (Retry(total=3, connect=None, read=None, redirect=None, status=None)) after connection broken by ‘NewConnectionError(’<pip._vendor.urllib3.connection.HTTPSConnection object at 0x7fbbf0832fd0>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution’)‘: /packages/f0/91/fdde4b2bbfea57856674ebd6168c235d2b69027fc30486f3f7c243b6723a/aiohue-4.7.0-py3-none-any.whl.metadata
WARNING: Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by ‘NewConnectionError(’<pip._vendor.urllib3.connection.HTTPSConnection object at 0x7fbbf0833850>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution’)‘: /packages/f0/91/fdde4b2bbfea57856674ebd6168c235d2b69027fc30486f3f7c243b6723a/aiohue-4.7.0-py3-none-any.whl.metadata
WARNING: Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None)) after connection broken by ‘NewConnectionError(’<pip._vendor.urllib3.connection.HTTPSConnection object at 0x7fbbf0831b90>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution’)‘: /packages/f0/91/fdde4b2bbfea57856674ebd6168c235d2b69027fc30486f3f7c243b6723a/aiohue-4.7.0-py3-none-any.whl.metadata
WARNING: Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by ‘NewConnectionError(’<pip._vendor.urllib3.connection.HTTPSConnection object at 0x7fbbf0838690>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution’)‘: /packages/f0/91/fdde4b2bbfea57856674ebd6168c235d2b69027fc30486f3f7c243b6723a/aiohue-4.7.0-py3-none-any.whl.metadata
ERROR: Could not install packages due to an OSError: HTTPSConnectionPool(host=‘files.pythonhosted.org’, port=443): Max retries exceeded with url: /packages/f0/91/fdde4b2bbfea57856674ebd6168c235d2b69027fc30486f3f7c243b6723a/aiohue-4.7.0-py3-none-any.whl.metadata (Caused by NewConnectionError(’<pip._vendor.urllib3.connection.HTTPSConnection object at 0x7fbbf0839090>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution’))
2023-12-10 09:10:37.383 ERROR (SyncWorker_2) [homeassistant.util.package] Unable to install package aiohue==4.7.0: WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None)) after connection broken by ‘NewConnectionError(’<pip._vendor.urllib3.connection.HTTPSConnection object at 0x7f3fd90eb4d0>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution’)': /packages/f0/91/fdde4b2bbfea57856674ebd6168c235d2b69027fc30486f3f7c243b6723a/aiohue-4.7.0-py3-none-any.whl.metadata

fomtooley · December 16, 2023, 7:17pm

issue:
my server doesn’t have bluetooth. and i run into an issue w/ this at ‘hass’

[homeassistant.setup] Setup of bluetooth is taking over 10 seconds.

hangs forever
& 2nd try no output - just hangs

any way i can mod to exclude bluetooth setup? i’m looking thru files now but no obvious solution yet

much obliged to anyone who can help, as unless i post again that i figured it out, means i’m still stuck - God bless

-p

mcll · January 8, 2024, 2:34pm

I have the same issue. Cannot install, it hangs because of the bluetooth which is missing. How to install HA?

mcll · January 9, 2024, 11:37am

I installed Linux to one of my laptop. Bluetooth is present there and is workng fine. But the HA install hangs there also, claiming thet it could not reset the power state of the bluetooth adapter, and could not cycle it. And this error is in loop forever…

2024-01-09 12:31:42.986 WARNING (MainThread) [bluetooth_auto_recovery.recover] Could not reset the power state of the Bluetooth adapter hci0 [C0:CB:38:AE:7A:ED] due to timeout after 5 seconds
2024-01-09 12:31:42.988 WARNING (MainThread) [bluetooth_auto_recovery.recover] Could not cycle the Bluetooth adapter hci0 [C0:CB:38:AE:7A:ED]: [Errno 1] Operation not permitted
2024-01-09 12:31:42.988 WARNING (MainThread) [bluetooth_auto_recovery.recover] Bluetooth management socket connection lost: [Errno 22] Invalid argument
2024-01-09 12:31:47.989 WARNING (MainThread) [bluetooth_auto_recovery.recover] Bluetooth adapter hci0 [C0:CB:38:AE:7A:ED] could not be reset: 
2024-01-09 12:31:47.992 WARNING (MainThread) [bluetooth_auto_recovery.recover] Closing Bluetooth adapter hci0 [C0:CB:38:AE:7A:ED] failed: [Errno 9] Bad file descriptor
2024-01-09 12:33:13.307 WARNING (MainThread) [bluetooth_auto_recovery.recover] Could not reset the power state of the Bluetooth adapter hci0 [C0:CB:38:AE:7A:ED] due to timeout after 5 seconds
2024-01-09 12:33:13.309 WARNING (MainThread) [bluetooth_auto_recovery.recover] Could not cycle the Bluetooth adapter hci0 [C0:CB:38:AE:7A:ED]: [Errno 1] Operation not permitted
2024-01-09 12:33:13.310 WARNING (MainThread) [bluetooth_auto_recovery.recover] Bluetooth management socket connection lost: [Errno 22] Invalid argument
2024-01-09 12:33:18.311 WARNING (MainThread) [bluetooth_auto_recovery.recover] Bluetooth adapter hci0 [C0:CB:38:AE:7A:ED] could not be reset: 
2024-01-09 12:33:18.313 WARNING (MainThread) [bluetooth_auto_recovery.recover] Closing Bluetooth adapter hci0 [C0:CB:38:AE:7A:ED] failed: [Errno 9] Bad file descriptor
2024-01-09 12:34:43.584 WARNING (MainThread) [bluetooth_auto_recovery.recover] Could not reset the power state of the Bluetooth adapter hci0 [C0:CB:38:AE:7A:ED] due to timeout after 5 seconds
2024-01-09 12:34:43.586 WARNING (MainThread) [bluetooth_auto_recovery.recover] Could not cycle the Bluetooth adapter hci0 [C0:CB:38:AE:7A:ED]: [Errno 1] Operation not permitted
2024-01-09 12:34:43.587 WARNING (MainThread) [bluetooth_auto_recovery.recover] Bluetooth management socket connection lost: [Errno 22] Invalid argument
2024-01-09 12:34:48.589 WARNING (MainThread) [bluetooth_auto_recovery.recover] Bluetooth adapter hci0 [C0:CB:38:AE:7A:ED] could not be reset: 
2024-01-09 12:34:48.591 WARNING (MainThread) [bluetooth_auto_recovery.recover] Closing Bluetooth adapter hci0 [C0:CB:38:AE:7A:ED] failed: [Errno 9] Bad file descriptor

corbrink · January 30, 2024, 7:27pm

The install worked for me, however, the add-ons is missing. How to go about enabling and using add-ons or is it not possible?

ubu · April 9, 2024, 1:50pm

ubu@ubu-desktop
OS: Ubuntu 23.10 mantic
Kernel: aarch64 Linux 6.5.0-1013-raspi
Uptime: 22m
Packages: 2612
Shell: bash 5.2.15
Disk: 24G / 110G (23%)
CPU: BCM2835 @ 4x 1.5GHz

RAM: 1372MiB / 3789MiB

Worked for me , thanks a lot.

rileonar · April 22, 2024, 1:11pm

Thank you for this guide, it was OK for me.
Just 3 points:

My bluetooth device was not correctly managed too, so hass command in step 17 output a lot of warning message (see mcll post)… BUT, after interrupting hass execution I could see that installation was correctly completed, so I could login in homeassistant GUI and disable Bluetooth item in order to avoid bluetooth_auto_recovery.recover messages
To install 2024.3.3 version, I’ve changed every occurence of python3.11 to python3.12 (step 5, 6, 13 and 15)
To manage service start/stop in Ubuntu 22.04 I’ve used systemctl environment, setup as following:
As root create file /etc/systemd/system/[email protected] with the content:

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

[Service]
Type=simple
User=%i
WorkingDirectory=/home/%i/.homeassistant
ExecStart=/srv/homeassistant/bin/hass -c "/home/%i/.homeassistant"
Restart=always
StandardOutput=journal
StandardError=journal+console

[Install]
WantedBy=multi-user.target

then run:
systemctl enable [email protected]
systemctl start [email protected]

My “home” 2 cents

chelmite · June 6, 2024, 1:07am

It’s now 2024. I have Ubuntu 24.04 installed.
Your guide is good, but

python is now at 3.12
python3 is always linked to the latest version, 3.12
I installed both homeassistant=2024.5 and 2024.6 (after uninstalling the previous version!) When I run hass, I get:

2024-06-05 18:04:08.469 ERROR (MainThread) [homeassistant.components.http] Failed to create HTTP server at port 8123: [Errno 98] error while attempting to bind on address (‘0.0.0.0’, 8123): address already in use

There is no other version of HA running, no virtual machines. lsof -i :8123 gives me the process id that is using the port. ps guax | grep <port> reports that the hass process is the one trying to use port 8123.

Does anyone know how to fix this?

php4u · July 15, 2024, 2:41pm

Thanks for the guide. When I try to start I get the following permission error:

user@selbynas:/etc/init.d$ ./homeassistant start
Password: ./homeassistant: 22: cannot create /var/run/HomeAssistant.pid: Permission denied
Running with PID:
user@selbynas:/etc/init.d$ su: Authentication failure

And, when I tried to enable and start the service, I received the error - service does not exist:

user@selbynas:/etc/init.d$ systemctl enable [email protected]

==== AUTHENTICATING FOR org.freedesktop.systemd1.manage-unit-files ====

Authentication is required to manage system service or unit files.

Authenticating as: user (user)

Password:

==== AUTHENTICATION COMPLETE ====

Failed to enable unit: Unit file [email protected] does not exist.

Thank you in advance!

sksanthosh · July 17, 2024, 12:07pm

I am running the home assistant on Ubuntu.

Is it possible to update the server using sudo apt update
And
sudo apt upgrade

To update the underlying system update.

pw44 · October 21, 2024, 1:22pm

Maybe an update, considering the UV component?