2.9 KiB
| layout | title | description | date | sidebar | comments | sharing | footer | redirect_from |
|---|---|---|---|---|---|---|---|---|
| page | Manual installation on a Raspberry Pi | Instructions to install Home Assistant on a Raspberry Pi running Raspbian Lite. | 2016-09-05 16:00 | true | false | true | true | /getting-started/installation-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.
When you run the `hass` command for the first time, it will download, install and cache the necessary libraries/dependencies. This procedure may take anywhere between 5 to 10 minutes. During that time, you may get "site cannot be reached" error when accessing the web interface. This will only happen for the first time, and subsequent restarts will be much faster.
If you want setup hass as a daemon and autostart it on boot please refer to Autostart Home Assistant.