Skip to content

Commit 379cadf

Browse files
authored
Add information for Raspberry Pi Image (home-assistant#995)
* Add information for Raspberry Pi Image, installation and general Raspberry Pi information update.
1 parent 202d8e4 commit 379cadf

File tree

4 files changed

+53
-2
lines changed

4 files changed

+53
-2
lines changed

source/_includes/asides/getting_started_navigation.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ <h1 class="title delta">Getting Started Guide</h1>
99
<ul>
1010
<li>{% active_link /getting-started/installation-raspberry-pi/ Raspberry Pi %}</li>
1111
<li>{% active_link /getting-started/installation-raspberry-pi-all-in-one/ Raspberry Pi All-In-One Installer %}</li>
12+
<li>{% active_link /getting-started/installation-raspberry-pi-image/ Raspberry Pi Image %}</li>
1213
<li>{% active_link /getting-started/installation-docker/ Docker %}</li>
1314
<li>{% active_link /getting-started/installation-vagrant/ Vagrant %}</li>
1415
<li>{% active_link /getting-started/installation-synology/ Synology NAS %}</li>

source/getting-started/installation-raspberry-pi-all-in-one.markdown

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
layout: page
33
title: "Raspberry Pi All-In-One Installer"
44
date: 2016-05-12 01:39
5-
comments: true
5+
comments: false
66
sharing: true
77
footer: true
88
---
Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
---
2+
layout: page
3+
title: "Hassbian image on a Raspberry Pi"
4+
description: "Instructions to install the Home Assistant Hassbian image on a Raspberry Pi."
5+
date: 2016-09-26 21:00
6+
sidebar: true
7+
comments: false
8+
sharing: true
9+
footer: true
10+
---
11+
12+
### {% linkable_title Hassbian %}
13+
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.
17+
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`.
19+
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.
21+
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/).
23+
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.
25+
26+
### {% linkable_title Installation %}
27+
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/).
29+
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).
31+
32+
### {% linkable_title Troubleshooting %}
33+
34+
If you run into any issues, please see [the troubleshooting page](/getting-started/troubleshooting/). It contains solutions to many of the more commonly encountered issues.
35+
36+
In addition to this site, check out these sources for additional help:
37+
38+
- [Forum](https://community.home-assistant.io) for Home Assistant discussions and questions.
39+
- [Gitter Chat Room](https://gitter.im/home-assistant/home-assistant) for real-time chat about Home Assistant.
40+
- [GitHub Page](https://github.com/home-assistant/home-assistant/issues) for issue reporting.
41+
42+
### [Next step: Configuring Home Assistant &raquo;](/getting-started/configuration/)

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

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
layout: page
3-
title: "Raspbian Lite on a Raspberry Pi"
3+
title: "Manual installation on a Raspberry Pi"
44
description: "Instructions to install Home Assistant on a Raspberry Pi runnning Raspbian Lite."
55
date: 2016-09-05 16:00
66
sidebar: true
@@ -11,6 +11,14 @@ footer: true
1111

1212
### {% linkable_title Installation %}
1313

14+
There's currently three documented ways to install Home Assistant on a Raspberry Pi.
15+
- [Manual installation](/getting-started/installation-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.
16+
- [Hassbian image](/getting-started/installation-raspberry-pi-image). Basic installation with the same settings as following the manual installation guide. Some additional software is preinstalled to make installation quicker and easier.
17+
- [All-in-One Installer](/getting-started/installation-raspberry-pi-all-in-one/). Fabric based installation script that installs and compiles many of the things an advanced Home Assistant install is likely to need.
18+
19+
20+
### {% linkable_title Manual Installation %}
21+
1422
This installation of Home Assistant requires the Raspberry Pi to run [Raspbian Lite](https://www.raspberrypi.org/downloads/raspbian/).
1523
The installation will be installed in a [Virtual Environment](/getting-started/installation-virtualenv) with minimal overhead. Instructions assume this is a new installation of Raspbian Lite.
1624

0 commit comments

Comments
 (0)