Hassbian Image for Raspberry Pi
The easiest way to install Home Assistant on your Raspberry Pi is by using Hassbian: a Raspberry Pi image with Home Assistant built-in. The image will install the latest version of Home Assistant on initial boot (~5 minutes).
- Download the latest image
- Flash the image to an SD card:
- Ensure your Raspberry Pi has access to the internet.
- Insert SD card to Raspberry Pi and turn it on. Initial installation of Home Assistant will take 5 minutes.
These instructions are also available as a video.
Home Assistant will now be available by navigating with a browser to http://ip-address-of-pi:8123. The default username is pi and password is raspberry (please change this by running passwd). The Home Assistant configuration is located at /home/homeassistant/.homeassistant/.
The following extras are included on the image:
- GPIO pins are ready to use.
- Mosquitto MQTT broker is installed (not activated by default).
- Bluetooth is ready to use (supported models only, no Bluetooth LE).
Some extra tips:
- Check out the list of Raspberry Pi hardware specific components.
- Z-Wave support can be installed by following the Getting started instructions for Z-Wave.
Technical Details
- Home Assistant is installed in a virtual Python environment at
src/homeassistant - Home Assistant will be started as a service run by the user
homeassistant
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.