Install Home Assistant on Arch Linux

Install Home Assistant on Arch Linux

Home Assistant is a Python 3 based home automation platform that can interface with a plethora of devices. It is relatively new and thus requires some knowledge especially when configuring it. Most of the configuration is done via YAML config file.


Install Home Assistant

Install Python 3 from the official repository.

sudo pacman -S python


Install Packer on Arch Linuxinstall Yaourt or use another package wrapper.


Install Python 3 package manager from AUR with packer.

sudo pacman -S python-pip


Install the package with pip.

sudo pip3 install homeassistant

Error message Could not find a version that satisfies the requirement home-assistant (from versions: ) No matching distribution found for home-assistant may mean that the wrong pip version is used, for example instead of pip3.


Update the package with pip.

sudo pip3 install --upgrade homeassistant


Configure Home Assistant

Create a system account and group.

sudo useradd -r -s /bin/false hass


Create a systemd script.

sudo nano /etc/systemd/system/home-assistant.service


Copy the script and save.

Description=Home Assistant

ExecStart=/usr/bin/hass --config /var/lib/home-assistant



Create configuration directory.

sudo mkdir /var/lib/home-assistant


Start manually for the first time to create the default configuration file.

sudo hass --config /var/lib/home-assistant


Change the owner permissions of the configuration directory.

sudo chown -R hass:hass /var/lib/home-assistant


Open the configuration file and add all options here when needed.

sudo nano /var/lib/configuration.yaml


Run Home Assistant

Start the systemd service.

sudo systemctl start home-assistant


Enable the systemd service to run on boot.

sudo systemctl enable home-assistant


Use Home Assistant

Default port is 8123 unless it has been changed manually. Change to the actual IP address of the server. Access Home Assistant via its web interface on and configure it from the settings page.