4.6 KiB
layout, title, description, date, sidebar, comments, sharing, footer
| layout | title | description | date | sidebar | comments | sharing | footer |
|---|---|---|---|---|---|---|---|
| page | Manual installation on a Raspberry Pi | Instructions to install Home Assistant on a Raspberry Pi runnning Raspbian Lite. | 2016-09-05 16:00 | true | false | true | true |
{% linkable_title Installation %}
There's currently three documented ways to install Home Assistant on a Raspberry Pi.
- Manual installation. Following this guide doing each step manually. This is highly recommended as a first installation since you get a good overview of the installation.
- Hassbian image. Basic installation with the same settings as following the manual installation guide. Some additional software is preinstalled to make installation quicker and easier. Installation uses
homeassistantuser. - All-in-One Installer. Fabric based installation script that installs and compiles many of the things an advanced Home Assistant install is likely to need. Installation uses
homeassistantuser.
Since each installation type uses a different user for Home Assistant, be sure to note and use the correct username for the `adduser` commands listed below for camera and GPIO extensions.
{% linkable_title Manual Installation %}
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 homeassistant_venv
$ source /srv/homeassistant/homeassistant_venv/bin/activate
Once you have activated the virtual environment you will notice the prompt change and then you can install Home Assistant.
(homeassistant_venv) homeassistant@raspberrypi:/srv/homeassistant $ pip3 install homeassistant
Start Home Assistant for the first time. This will complete the installation, create the .homeasssistant configuration directory in the /home/homeassistant directory and install any basic dependencies.
(homeassistant_venv) $ hass
You can now reach your installation on your raspberry pi over the web interface on http://ipaddress:8123.
For instruction on how to configure Home Assistant continue on with Configuring Home Assistant.
{% linkable_title Troubleshooting %}
If you run into any issues, please see the troubleshooting page. It contains solutions to many of the more commonly encountered issues.
In addition to this site, check out these sources for additional help:
- Forum for Home Assistant discussions and questions.
- Gitter Chat Room for real-time chat about Home Assistant.
- GitHub Page for issue reporting.
{% linkable_title What's next %}
If you want to have Home Assistant start on boot, autostart instructions can be found here.
To see what Home Assistant can do, launch demo mode: hass --demo-mode or visit the demo page.