From 327409a825f72aa221c8f89da7af657878e34b40 Mon Sep 17 00:00:00 2001 From: Travis CI Date: Sat, 22 Oct 2016 04:09:21 +0000 Subject: [PATCH] Site updated at 2016-10-22 04:09:21 UTC --- atom.xml | 2 +- blog/categories/community/atom.xml | 2 +- blog/categories/device-tracking/atom.xml | 2 +- blog/categories/esp8266/atom.xml | 2 +- blog/categories/how-to/atom.xml | 2 +- blog/categories/ibeacons/atom.xml | 2 +- blog/categories/internet-of-things/atom.xml | 2 +- blog/categories/iot-data/atom.xml | 2 +- blog/categories/micropython/atom.xml | 2 +- blog/categories/mqtt/atom.xml | 2 +- blog/categories/organisation/atom.xml | 2 +- blog/categories/owntracks/atom.xml | 2 +- blog/categories/presence-detection/atom.xml | 2 +- .../public-service-announcement/atom.xml | 2 +- blog/categories/release-notes/atom.xml | 2 +- blog/categories/survey/atom.xml | 2 +- blog/categories/talks/atom.xml | 2 +- blog/categories/technology/atom.xml | 2 +- blog/categories/user-stories/atom.xml | 2 +- blog/categories/video/atom.xml | 2 +- blog/categories/website/atom.xml | 2 +- .../index.html | 124 ++++++++++++++++-- getting-started/updating/index.html | 2 +- sitemap.xml | 30 ++--- 24 files changed, 150 insertions(+), 48 deletions(-) diff --git a/atom.xml b/atom.xml index 2ac292a388..bf6348285c 100644 --- a/atom.xml +++ b/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Home Assistant]]> - 2016-10-21T21:10:32+00:00 + 2016-10-22T04:07:10+00:00 https://home-assistant.io/ diff --git a/blog/categories/community/atom.xml b/blog/categories/community/atom.xml index f2903dadbe..4572ee9709 100644 --- a/blog/categories/community/atom.xml +++ b/blog/categories/community/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Community | Home Assistant]]> - 2016-10-21T21:10:32+00:00 + 2016-10-22T04:07:10+00:00 https://home-assistant.io/ diff --git a/blog/categories/device-tracking/atom.xml b/blog/categories/device-tracking/atom.xml index edaf0ff234..89c5eb42c5 100644 --- a/blog/categories/device-tracking/atom.xml +++ b/blog/categories/device-tracking/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Device-Tracking | Home Assistant]]> - 2016-10-21T21:10:32+00:00 + 2016-10-22T04:07:10+00:00 https://home-assistant.io/ diff --git a/blog/categories/esp8266/atom.xml b/blog/categories/esp8266/atom.xml index 3fc57962a0..649d63541b 100644 --- a/blog/categories/esp8266/atom.xml +++ b/blog/categories/esp8266/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: ESP8266 | Home Assistant]]> - 2016-10-21T21:10:32+00:00 + 2016-10-22T04:07:10+00:00 https://home-assistant.io/ diff --git a/blog/categories/how-to/atom.xml b/blog/categories/how-to/atom.xml index ff4c650b4d..4400593592 100644 --- a/blog/categories/how-to/atom.xml +++ b/blog/categories/how-to/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: How-To | Home Assistant]]> - 2016-10-21T21:10:32+00:00 + 2016-10-22T04:07:10+00:00 https://home-assistant.io/ diff --git a/blog/categories/ibeacons/atom.xml b/blog/categories/ibeacons/atom.xml index 18cca4c582..7c97c6845e 100644 --- a/blog/categories/ibeacons/atom.xml +++ b/blog/categories/ibeacons/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: iBeacons | Home Assistant]]> - 2016-10-21T21:10:32+00:00 + 2016-10-22T04:07:10+00:00 https://home-assistant.io/ diff --git a/blog/categories/internet-of-things/atom.xml b/blog/categories/internet-of-things/atom.xml index 1aef51f177..4e15677166 100644 --- a/blog/categories/internet-of-things/atom.xml +++ b/blog/categories/internet-of-things/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Internet-of-Things | Home Assistant]]> - 2016-10-21T21:10:32+00:00 + 2016-10-22T04:07:10+00:00 https://home-assistant.io/ diff --git a/blog/categories/iot-data/atom.xml b/blog/categories/iot-data/atom.xml index 04035d20f9..3c7ae92bc8 100644 --- a/blog/categories/iot-data/atom.xml +++ b/blog/categories/iot-data/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: IoT-Data | Home Assistant]]> - 2016-10-21T21:10:32+00:00 + 2016-10-22T04:07:10+00:00 https://home-assistant.io/ diff --git a/blog/categories/micropython/atom.xml b/blog/categories/micropython/atom.xml index 84e12a7282..91c4efabdc 100644 --- a/blog/categories/micropython/atom.xml +++ b/blog/categories/micropython/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Micropython | Home Assistant]]> - 2016-10-21T21:10:32+00:00 + 2016-10-22T04:07:10+00:00 https://home-assistant.io/ diff --git a/blog/categories/mqtt/atom.xml b/blog/categories/mqtt/atom.xml index 08aa01df45..f739f34fb9 100644 --- a/blog/categories/mqtt/atom.xml +++ b/blog/categories/mqtt/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: MQTT | Home Assistant]]> - 2016-10-21T21:10:32+00:00 + 2016-10-22T04:07:10+00:00 https://home-assistant.io/ diff --git a/blog/categories/organisation/atom.xml b/blog/categories/organisation/atom.xml index e7a21c9463..10eb5674b3 100644 --- a/blog/categories/organisation/atom.xml +++ b/blog/categories/organisation/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Organisation | Home Assistant]]> - 2016-10-21T21:10:32+00:00 + 2016-10-22T04:07:10+00:00 https://home-assistant.io/ diff --git a/blog/categories/owntracks/atom.xml b/blog/categories/owntracks/atom.xml index 14847fbdc8..70bb978a56 100644 --- a/blog/categories/owntracks/atom.xml +++ b/blog/categories/owntracks/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: OwnTracks | Home Assistant]]> - 2016-10-21T21:10:32+00:00 + 2016-10-22T04:07:10+00:00 https://home-assistant.io/ diff --git a/blog/categories/presence-detection/atom.xml b/blog/categories/presence-detection/atom.xml index fa854a915c..b714abdb92 100644 --- a/blog/categories/presence-detection/atom.xml +++ b/blog/categories/presence-detection/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Presence-Detection | Home Assistant]]> - 2016-10-21T21:10:32+00:00 + 2016-10-22T04:07:10+00:00 https://home-assistant.io/ diff --git a/blog/categories/public-service-announcement/atom.xml b/blog/categories/public-service-announcement/atom.xml index 73ba7ad484..e23c52d3fa 100644 --- a/blog/categories/public-service-announcement/atom.xml +++ b/blog/categories/public-service-announcement/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Public-Service-Announcement | Home Assistant]]> - 2016-10-21T21:10:32+00:00 + 2016-10-22T04:07:10+00:00 https://home-assistant.io/ diff --git a/blog/categories/release-notes/atom.xml b/blog/categories/release-notes/atom.xml index b451a3833a..f8567620a7 100644 --- a/blog/categories/release-notes/atom.xml +++ b/blog/categories/release-notes/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Release-Notes | Home Assistant]]> - 2016-10-21T21:10:32+00:00 + 2016-10-22T04:07:10+00:00 https://home-assistant.io/ diff --git a/blog/categories/survey/atom.xml b/blog/categories/survey/atom.xml index c75631fa75..da3d0501db 100644 --- a/blog/categories/survey/atom.xml +++ b/blog/categories/survey/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Survey | Home Assistant]]> - 2016-10-21T21:10:32+00:00 + 2016-10-22T04:07:10+00:00 https://home-assistant.io/ diff --git a/blog/categories/talks/atom.xml b/blog/categories/talks/atom.xml index bd52526261..322376c98b 100644 --- a/blog/categories/talks/atom.xml +++ b/blog/categories/talks/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Talks | Home Assistant]]> - 2016-10-21T21:10:32+00:00 + 2016-10-22T04:07:10+00:00 https://home-assistant.io/ diff --git a/blog/categories/technology/atom.xml b/blog/categories/technology/atom.xml index cf914102de..59ba0d9376 100644 --- a/blog/categories/technology/atom.xml +++ b/blog/categories/technology/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Technology | Home Assistant]]> - 2016-10-21T21:10:32+00:00 + 2016-10-22T04:07:10+00:00 https://home-assistant.io/ diff --git a/blog/categories/user-stories/atom.xml b/blog/categories/user-stories/atom.xml index 64ad10376d..0c64255c48 100644 --- a/blog/categories/user-stories/atom.xml +++ b/blog/categories/user-stories/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: User-Stories | Home Assistant]]> - 2016-10-21T21:10:32+00:00 + 2016-10-22T04:07:10+00:00 https://home-assistant.io/ diff --git a/blog/categories/video/atom.xml b/blog/categories/video/atom.xml index 1f0a0722d2..953abc0e73 100644 --- a/blog/categories/video/atom.xml +++ b/blog/categories/video/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Video | Home Assistant]]> - 2016-10-21T21:10:32+00:00 + 2016-10-22T04:07:10+00:00 https://home-assistant.io/ diff --git a/blog/categories/website/atom.xml b/blog/categories/website/atom.xml index 3cab41df35..33575f39ba 100644 --- a/blog/categories/website/atom.xml +++ b/blog/categories/website/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Website | Home Assistant]]> - 2016-10-21T21:10:32+00:00 + 2016-10-22T04:07:10+00:00 https://home-assistant.io/ diff --git a/getting-started/installation-raspberry-pi-image/index.html b/getting-started/installation-raspberry-pi-image/index.html index 6b4b541485..f1d1be08b6 100644 --- a/getting-started/installation-raspberry-pi-image/index.html +++ b/getting-started/installation-raspberry-pi-image/index.html @@ -7,26 +7,26 @@ - Hassbian image for Raspberry Pi - Home Assistant + HASSbian image for Raspberry Pi - Home Assistant - + - + - + - - + + @@ -83,13 +83,13 @@

- Hassbian Image for Raspberry Pi + 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).

+

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).

  1. Download the latest image
    2. @@ -97,11 +97,11 @@
  2. Ensure your Raspberry Pi has access to the internet.
    3. -
  3. Insert SD card to Raspberry Pi and turn it on. Initial installation of Home Assistant will take 5 minutes.
    4. +
  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.

@@ -126,10 +126,112 @@

Technical Details

    -
  • Home Assistant is installed in a virtual Python environment at src/homeassistant
    • +
  • 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
    • +
  • The configuration is located at /home/homeassistant/.homeassistant
+

Managing your HASSbian installation

+

Login to HASSbian on the Raspberry Pi

+

To login to your Raspberry Pi running HASSbian your going to be using a ssh client. Depending on your platform there are several alternatives for doing this. Linux and Max OS generally have a ssh client installed. Windows users are recommended to download and install the ssh client Putty.

+ +

Connect to the Raspberry Pi over ssh. Default user name is pi and password is raspberry.
+Linux and Mac OS users execute the following command in a terminal.

+
$ ssh pi@ip-address-of-pi
+
+
+

Windows users start Putty, enter the IP address of the Raspberry Pi in the Host name field and port 22 in the Port field. Then click Open and a terminal window will open. Enter the credentials. Default user name is pi and password is raspberry.

+ +

Start/Stop/Restart Home Assistant on HaSSbian

+

Log in as the pi account account and execute the following commands:

+
sudo systemctl stop home-assistant@homeassistant.service 
+
+
+

Replace stop with start or restart to get the desired functionality. +To get the current state of the homeassistant.service replace stop with status.

+ +

Update Home Assistant on HASSbian

+

Log in as the pi account and execute the following commands:

+
sudo systemctl stop home-assistant@homeassistant.service 
+sudo su -s /bin/bash homeassistant
+source /srv/homeassistant/bin/activate
+pip3 install --upgrade homeassistant
+exit
+sudo systemctl start home-assistant@homeassistant.service
+
+
+

This will in order do the following:

+
    +
  • Stop the Home Assistant service running on HASSbian
    • +
  • Open a shell as the homeassistant user running the Homeassistant service and that has ownership over the Home Assistant installation.
    • +
  • Change into the virtual Python environment at /src/homeassistant/ containing the Home Assistant installation.
    • +
  • Upgrade the Home Assistant installation to the latest release.
    • +
  • Exit the shell and return to the pi user.
    • +
  • Restart the Home Assistant service.
    • +
+ +

Manually launch Home Assistant on HASSbian

+

Log in as the pi account and execute the following commands:

+
sudo su -s /bin/bash homeassistant
+source /srv/homeassistant/bin/activate
+hass
+
+
+

This will start Home Assistant in your shell and output anything that ends up in the log and more into the console. This will fail if the Home Assistant service is already running so don’t forget to stop it first.

+ +

Check your configuration on HASSbian

+

Log in as the pi account and execute the following commands:

+
sudo su -s /bin/bash homeassistant
+source /srv/homeassistant/bin/activate
+hass --script check_config
+
+
+

This will output any errors in your configuration files to console.

+ +

Read the Home Assistant log file on HASSbian

+

Log in as the pi account and execute the following commands:

+
sudo su -s /bin/bash homeassistant
+cd /home/homeassistant/.homeassistant
+nano homeassistant.log
+
+
+

This will in order do the following:

+
    +
  • Open a shell as the homeassistant user.
    • +
  • Change directory to the Home Assistant configuration directory.
    • +
  • Open the log file in the nano editor.
    • +
+ +

Optionaly, you can also view the log with journalctl.
+Log in as the pi account and execute the following commands:

+
sudo journalctl -fu home-assistant@homeassistant.service
+
+
+ +

Edit the Home Assistant configuration on HASSbian

+

Log in as the pi account and execute the following commands:

+
sudo su -s /bin/bash homeassistant
+cd /home/homeassistant/.homeassistant
+nano configuration.yaml
+
+
+

This will in order do the following:

+
    +
  • Open a shell as the homeassistant user.
    • +
  • Change directory to the Home Assistant configuration directory.
    • +
  • Open the configuration file in the nano editor. +It’s generally recommended that you read the Getting started guide for how to configure Home Assistant.
    • +
+ +

Upgrade and update HASSbian

+

HASSbian is based on Raspbian and uses the same repositories. Any changes to Raspbian will be reflected in HASSbian. To update and upgrade system packages and installed software (excluding Home Assistant) do the following. +Log in as the pi account and execute the following commands:

+
sudo apt-get update
+sudo apt-get upgrade
+
+
+

Press Y to confirm that you would like to continue.

+

Troubleshooting

If you run into any issues, please see the troubleshooting page. It contains solutions to many of the more commonly encountered issues.

diff --git a/getting-started/updating/index.html b/getting-started/updating/index.html index d2c3870fb4..ffc6f4abd0 100644 --- a/getting-started/updating/index.html +++ b/getting-started/updating/index.html @@ -95,7 +95,7 @@ -

Different installation methods as Raspberry Pi All-In-One Installer, Vagrant, or Virtualenv may have an alternative way for updating Home Assistant.

+

Different installation methods as HASSbian, Raspberry Pi All-In-One Installer, Vagrant, or Virtualenv may have an alternative way for updating Home Assistant.

After updating, restart Home Assistant for the changes to take effect. This means that you have to restart hass itself or the autostarting daemon if you use any.

diff --git a/sitemap.xml b/sitemap.xml index 361a8afe3e..c84328b2e0 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -2180,62 +2180,62 @@ https://home-assistant.io/demo/frontend.html -2016-10-21T21:09:46+00:00 +2016-10-22T04:06:31+00:00 https://home-assistant.io/demo/index.html -2016-10-21T21:09:46+00:00 +2016-10-22T04:06:31+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-event.html -2016-10-21T21:09:46+00:00 +2016-10-22T04:06:31+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-info.html -2016-10-21T21:09:46+00:00 +2016-10-22T04:06:31+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-service.html -2016-10-21T21:09:46+00:00 +2016-10-22T04:06:31+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-state.html -2016-10-21T21:09:46+00:00 +2016-10-22T04:06:31+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-template.html -2016-10-21T21:09:46+00:00 +2016-10-22T04:06:31+00:00 https://home-assistant.io/demo/panels/ha-panel-history.html -2016-10-21T21:09:46+00:00 +2016-10-22T04:06:31+00:00 https://home-assistant.io/demo/panels/ha-panel-iframe.html -2016-10-21T21:09:46+00:00 +2016-10-22T04:06:31+00:00 https://home-assistant.io/demo/panels/ha-panel-logbook.html -2016-10-21T21:09:46+00:00 +2016-10-22T04:06:31+00:00 https://home-assistant.io/demo/panels/ha-panel-map.html -2016-10-21T21:09:46+00:00 +2016-10-22T04:06:31+00:00 https://home-assistant.io/googlef4f3693c209fe788.html -2016-10-21T21:09:46+00:00 +2016-10-22T04:06:31+00:00 https://home-assistant.io/static/fonts/roboto/DESCRIPTION.en_us.html -2016-10-21T21:09:46+00:00 +2016-10-22T04:06:31+00:00 https://home-assistant.io/static/fonts/robotomono/DESCRIPTION.en_us.html -2016-10-21T21:09:46+00:00 +2016-10-22T04:06:31+00:00 https://home-assistant.io/static/mdi-demo.html -2016-10-21T21:09:46+00:00 +2016-10-22T04:06:31+00:00