Hassbian Image on a Raspberry Pi
Hassbian
We finally have a Raspberry Pi image! It’s been named Hassbian in honor of Raspbian.
This image comes pre-installed with the dependencies, permissions and so on for Home Assistant. Image is based on the same install instructions as the Manual installation.
It’s based on Raspbian Lite and generated with a fork of the same script that builds the official Raspbian images. Please note that this project has no association with the Raspberry Pi foundation or their projects.
On first boot the latest release of Home Assistant will be installed in a Virtual Environment at /srv/homeassistant and started as a service run by the user homeassistant. Since this is done automatically it’s required that the Raspberry Pi is connected to the internet with a ethernet cable. Installation takes about 5 minutes on first boot and after that you can connect to your Raspberry Pi on ipaddress:8123.
Pre-installed on this image is the MQTT broker Mosquitto, Bluetooth support for none Bluetooth LE and settings for the homeassistant user to use the GPIO pins of the Raspberry Pi. Mosquitto is not activated by default.
As it is today there is no pre-compiled Z-Wave support but it can be installed by following the Getting started instructions for Z-Wave.
For Raspberry Pi hardware specific components have a look at our install guide for the Raspberry Pi. Default password for the pi user is raspberry and is highly recommended to be changed.
Installation
The image can be found as a release in the pi-gen repository.
Installation instructions are the same as for Raspbian and it’s recommended to follow these.
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.