Installing Hassbian

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 (~10 minutes).

  1. Download the Hassbian image (364 MB)
  2. Use Etcher to flash the image to your SD card
  3. Ensure your Raspberry Pi has wired access to the internet.
  4. Insert SD card to Raspberry Pi and turn it on. Initial installation of Home Assistant will take about 5 minutes.

These instructions are also available as a video. Additional information is available in this video.

After initial boot, you can reach Home Assistant in your browser at http://hassbian.local:8123. If you want to login via SSH, 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.
  • Bluetooth is ready to use (supported models only, no Bluetooth LE).
  • SSH server is enabled.
  • A tool called hassbian-config.

Technical Details

  • Home Assistant is installed in a virtual Python environment at /srv/homeassistant/
  • Home Assistant will be started as a service run by the user homeassistant
  • The configuration is located at /home/homeassistant/.homeassistant