Manual installation on a Raspberry Pi


This installation of Home Assistant requires the Raspberry Pi to run Raspbian Lite. The installation will be installed in a Virtual Environment with minimal overhead. Instructions assume this is a new installation of Raspbian Lite.

Connect to the Raspberry Pi over SSH. Default password is raspberry. You will need to enable SSH access. The Raspberry Pi website has instructions here.

$ ssh pi@ipadress

Changing the default password is encouraged.

$ passwd

Update the system.

$ sudo apt-get update
$ sudo apt-get upgrade -y

Install the dependencies.

$ sudo apt-get install python3 python3-venv python3-pip

Add an account for Home Assistant called homeassistant. Since this account is only for running Home Assistant the extra arguments of -rm is added to create a system account and create a home directory.

$ sudo useradd -rm homeassistant

Next we will create a directory for the installation of Home Assistant and change the owner to the homeassistant account.

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

Next up is to create and change to a virtual environment for Home Assistant. This will be done as the homeassistant account.

$ sudo su -s /bin/bash homeassistant
$ cd /srv/homeassistant
$ python3 -m venv .
$ source bin/activate

Once you have activated the virtual environment you will notice the prompt change and then you can install Home Assistant.

(homeassistant) homeassistant@raspberrypi:/srv/homeassistant $ pip3 install homeassistant

Start Home Assistant for the first time. This will complete the installation, create the .homeassistant configuration directory in the /home/homeassistant directory and install any basic dependencies.

(homeassistant) $ hass

You can now reach your installation on your Raspberry Pi over the web interface on http://ipaddress:8123.