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
You will need to enable SSH access. The Raspberry Pi website has instructions here.
$ ssh [email protected]
Changing the default password is encouraged.
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
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
$ 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
$ 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) [email protected]:/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.