Skip to content

Commit ba779ec

Browse files
balloobballoob
committed
Update Pi image instructions
1 parent 89c4224 commit ba779ec

File tree

1 file changed

+40
-13
lines changed

1 file changed

+40
-13
lines changed

‎source/getting-started/installation-raspberry-pi-image.markdown

Lines changed: 40 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,33 +1,54 @@
11
---
22
layout: page
3-
title: "Hassbian image on a Raspberry Pi"
4-
description: "Instructions to install the Home Assistant Hassbian image on a Raspberry Pi."
3+
title: "Hassbian image for Raspberry Pi"
4+
description: "Instructions to flash the Home Assistant Hassbian image on a Raspberry Pi."
55
date: 2016-09-26 21:00
66
sidebar: true
77
comments: false
88
sharing: true
99
footer: true
1010
---
1111

12-
### {% linkable_title Hassbian %}
12+
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).
1313

14-
We finally have a Raspberry Pi image! It's been named Hassbian in honor of Raspbian.
15-
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](/getting-started/installation-raspberry-pi/).
16-
It's based on Raspbian Lite and generated with a fork of the same [script](https://github.com/home-assistant/pi-gen) that builds the [official Raspbian images](raspberrypi.org/downloads/raspbian/). Please note that this project has no association with the Raspberry Pi foundation or their projects.
14+
1. [Download the latest image][image-download]
15+
2. Flash the image to an SD card:
16+
- [Windows][flash-windows]
17+
- [Linux][flash-linux]
18+
- [Mac][flash-macos]
19+
3. Ensure your Raspberry Pi has access to the internet.
20+
4. Insert SD card to Raspberry Pi and turn it on. Initial installation of Home Assistant will take 5 minutes.
1721

18-
On first boot the latest release of Home Assistant will be installed in a [Virtual Environment](getting-started/installation-virtualenv) 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`.
22+
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`)
1923

20-
Pre-installed on this image is the MQTT broker [Mosquitto](https://mosquitto.org/), 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.
24+
The following extras are included on the image:
2125

22-
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](/getting-started/z-wave/).
26+
- GPIO pins are ready to use.
27+
- Mosquitto MQTT broker is installed (not activated by default).
28+
- Bluetooth is ready to use (supported models only, no Bluetooth LE).
2329

24-
For Raspberry Pi hardware specific components have a look at our [install guide for the Raspberry Pi](/getting-started/installation-raspberry-pi/#raspberry-pi-hardware-specific-components). Default password for the `pi` user is `raspberry` and is highly recommended to be changed.
30+
Some extra tips:
2531

26-
### {% linkable_title Installation %}
32+
- Check out the list of [Raspberry Pi hardware specific components][pi-components].
33+
- Z-Wave support can be installed by following the [Getting started instructions for Z-Wave](/getting-started/z-wave/).
2734

28-
The image can be found as a [release](https://github.com/home-assistant/pi-gen/releases) in the [pi-gen repository](https://github.com/home-assistant/pi-gen/).
35+
### {% linkable_title Technical Details %}
2936

30-
Installation instructions are the same as for Raspbian and it's recommended to follow [these](https://www.raspberrypi.org/documentation/installation/installing-images/README.md).
37+
- Home Assistant is installed in a virtual Python environment at `src/homeassistant`
38+
- Home Assistant will be started as a service run by the user `homeassistant`
39+
40+
{% comment %}
41+
42+
TODO:
43+
44+
Add instructions:
45+
46+
- How to login via shell (?) or at least mention how to work with a Pi
47+
- How to restart HASS
48+
- How to see the logs for config validation
49+
- How to update the config
50+
51+
{% endcomment %}
3152

3253
### {% linkable_title Troubleshooting %}
3354

@@ -40,3 +61,9 @@ In addition to this site, check out these sources for additional help:
4061
- [GitHub Page](https://github.com/home-assistant/home-assistant/issues) for issue reporting.
4162

4263
### [Next step: Configuring Home Assistant »](/getting-started/configuration/)
64+
65+
[image-download]: https://github.com/home-assistant/pi-gen/releases
66+
[flash-linux]: https://www.raspberrypi.org/documentation/installation/installing-images/linux.md
67+
[flash-macos]: https://www.raspberrypi.org/documentation/installation/installing-images/mac.md
68+
[flash-windows]: https://www.raspberrypi.org/documentation/installation/installing-images/windows.md
69+
[pi-components]: /getting-started/installation-raspberry-pi/#raspberry-pi-hardware-specific-components

0 commit comments

Comments
 (0)