diff --git a/atom.xml b/atom.xml index fcae9fdf43..eb7f7e99fe 100644 --- a/atom.xml +++ b/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Home Assistant]]> - 2016-08-14T18:40:43+00:00 + 2016-08-14T19:30:18+00:00 https://home-assistant.io/ diff --git a/blog/categories/community/atom.xml b/blog/categories/community/atom.xml index fffa5f6d34..c32d9063ba 100644 --- a/blog/categories/community/atom.xml +++ b/blog/categories/community/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Community | Home Assistant]]> - 2016-08-14T18:40:43+00:00 + 2016-08-14T19:30:18+00:00 https://home-assistant.io/ diff --git a/blog/categories/device-tracking/atom.xml b/blog/categories/device-tracking/atom.xml index 96d7f79602..e0e5401c85 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-08-14T18:40:43+00:00 + 2016-08-14T19:30:18+00:00 https://home-assistant.io/ diff --git a/blog/categories/esp8266/atom.xml b/blog/categories/esp8266/atom.xml index 63c9bae7ad..cb6efdab9b 100644 --- a/blog/categories/esp8266/atom.xml +++ b/blog/categories/esp8266/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: ESP8266 | Home Assistant]]> - 2016-08-14T18:40:43+00:00 + 2016-08-14T19:30:18+00:00 https://home-assistant.io/ diff --git a/blog/categories/how-to/atom.xml b/blog/categories/how-to/atom.xml index 136115ee0d..69c97aa817 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-08-14T18:40:43+00:00 + 2016-08-14T19:30:18+00:00 https://home-assistant.io/ diff --git a/blog/categories/ibeacons/atom.xml b/blog/categories/ibeacons/atom.xml index 4bd6ff3730..d89404dec6 100644 --- a/blog/categories/ibeacons/atom.xml +++ b/blog/categories/ibeacons/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: iBeacons | Home Assistant]]> - 2016-08-14T18:40:43+00:00 + 2016-08-14T19:30:18+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 b260521473..8f70eb7648 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-08-14T18:40:43+00:00 + 2016-08-14T19:30:18+00:00 https://home-assistant.io/ diff --git a/blog/categories/iot-data/atom.xml b/blog/categories/iot-data/atom.xml index 3baacc4052..6a6fb03d63 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-08-14T18:40:43+00:00 + 2016-08-14T19:30:18+00:00 https://home-assistant.io/ diff --git a/blog/categories/mqtt/atom.xml b/blog/categories/mqtt/atom.xml index f325212a7b..0f6dc8bece 100644 --- a/blog/categories/mqtt/atom.xml +++ b/blog/categories/mqtt/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: MQTT | Home Assistant]]> - 2016-08-14T18:40:43+00:00 + 2016-08-14T19:30:18+00:00 https://home-assistant.io/ diff --git a/blog/categories/organisation/atom.xml b/blog/categories/organisation/atom.xml index 8771e23a6e..8f0bfb92aa 100644 --- a/blog/categories/organisation/atom.xml +++ b/blog/categories/organisation/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Organisation | Home Assistant]]> - 2016-08-14T18:40:43+00:00 + 2016-08-14T19:30:18+00:00 https://home-assistant.io/ diff --git a/blog/categories/owntracks/atom.xml b/blog/categories/owntracks/atom.xml index 735ba7ab0c..6cd5c19413 100644 --- a/blog/categories/owntracks/atom.xml +++ b/blog/categories/owntracks/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: OwnTracks | Home Assistant]]> - 2016-08-14T18:40:43+00:00 + 2016-08-14T19:30:18+00:00 https://home-assistant.io/ diff --git a/blog/categories/presence-detection/atom.xml b/blog/categories/presence-detection/atom.xml index 5bd36fc194..440820532c 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-08-14T18:40:43+00:00 + 2016-08-14T19:30:18+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 4907a1676d..692604c036 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-08-14T18:40:43+00:00 + 2016-08-14T19:30:18+00:00 https://home-assistant.io/ diff --git a/blog/categories/release-notes/atom.xml b/blog/categories/release-notes/atom.xml index eb5fa8694a..d8f933abca 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-08-14T18:40:43+00:00 + 2016-08-14T19:30:18+00:00 https://home-assistant.io/ diff --git a/blog/categories/survey/atom.xml b/blog/categories/survey/atom.xml index 1696664f7b..ba92839f83 100644 --- a/blog/categories/survey/atom.xml +++ b/blog/categories/survey/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Survey | Home Assistant]]> - 2016-08-14T18:40:43+00:00 + 2016-08-14T19:30:18+00:00 https://home-assistant.io/ diff --git a/blog/categories/talks/atom.xml b/blog/categories/talks/atom.xml index 52e28880b1..5e11d04798 100644 --- a/blog/categories/talks/atom.xml +++ b/blog/categories/talks/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Talks | Home Assistant]]> - 2016-08-14T18:40:43+00:00 + 2016-08-14T19:30:18+00:00 https://home-assistant.io/ diff --git a/blog/categories/technology/atom.xml b/blog/categories/technology/atom.xml index f4da843027..9e45b49743 100644 --- a/blog/categories/technology/atom.xml +++ b/blog/categories/technology/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Technology | Home Assistant]]> - 2016-08-14T18:40:43+00:00 + 2016-08-14T19:30:18+00:00 https://home-assistant.io/ diff --git a/blog/categories/user-stories/atom.xml b/blog/categories/user-stories/atom.xml index 85c3f3e9e0..ca773ccf61 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-08-14T18:40:43+00:00 + 2016-08-14T19:30:18+00:00 https://home-assistant.io/ diff --git a/blog/categories/video/atom.xml b/blog/categories/video/atom.xml index b26d14c0af..cc667e7eeb 100644 --- a/blog/categories/video/atom.xml +++ b/blog/categories/video/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Video | Home Assistant]]> - 2016-08-14T18:40:43+00:00 + 2016-08-14T19:30:18+00:00 https://home-assistant.io/ diff --git a/blog/categories/website/atom.xml b/blog/categories/website/atom.xml index 234a6467aa..d2772be59c 100644 --- a/blog/categories/website/atom.xml +++ b/blog/categories/website/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Website | Home Assistant]]> - 2016-08-14T18:40:43+00:00 + 2016-08-14T19:30:18+00:00 https://home-assistant.io/ diff --git a/getting-started/configuration/index.html b/getting-started/configuration/index.html index 486447db35..f4675a29ad 100644 --- a/getting-started/configuration/index.html +++ b/getting-started/configuration/index.html @@ -89,20 +89,45 @@
-

Home Assistant will create a configuration folder when it is run for the first time. The location of the folder differs between operating systems: on OS X and Linux it’s ~/.homeassistant and on Windows it’s %APPDATA%/.homeassistant. If you want to use a different folder for configuration, run hass --config path/to/config.

+

When launched for the first time, Home Assistant will write a default configuration file enabling the web interface and device discovery. It can take up to a minute for your devices to be discovered and show up in the user interface.

-

Inside your configuration folder is the file configuration.yaml. This is the main file that contains which components will be loaded and what their configuration is. This file contains YAML code, which is explained briefly below. An example configuration file is located here.

+

The location of the folder differs between operating systems:

-

When launched for the first time, Home Assistant will write a default configuration file enabling the web interface and device discovery. It can take up to a minute for your devices to be discovered and show up in the user interface.

+ + + + + + + + + + + + + + + + + + + + + +
OSPath
OS X~/.homeassistant
Linux~/.homeassistant
Windows%APPDATA%/.homeassistant
-

If you run into trouble while configuring Home Assistant, have a look at the configuration troubleshooting page.

+

If you want to use a different folder for configuration, use the config command line parameter: hass --config path/to/config.

-

- Install colorlog ($ pip install colorlog) to make the console output easier to read, hence also easier to catch errors and warnings. -

+

Inside your configuration folder is the file configuration.yaml. This is the main file that contains which components will be loaded and what their configuration is. Throughout the documentation you will find snippets that you can add to your configuration file to enable that functionality.

+ +

If you run into trouble while configuring Home Assistant, have a look at the configuration troubleshooting page and at the configuration.yaml examples.

- You will have to restart Home Assistant each time you make changes in configuration.yaml in order for these to take effect. + You will have to restart Home Assistant for changes to configuration.yaml take effect. +

+ +

+ Install colorlog ($ pip3 install colorlog) to make the console output easier to read, hence also easier to catch errors and warnings.

Next step: Get familiar with YAML »

diff --git a/sitemap.xml b/sitemap.xml index b63271a2c4..6edbe32ebc 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -2081,62 +2081,62 @@ https://home-assistant.io/demo/frontend.html - 2016-08-14T18:40:00+00:00 + 2016-08-14T19:29:35+00:00 https://home-assistant.io/demo/index.html - 2016-08-14T18:40:00+00:00 + 2016-08-14T19:29:35+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-event.html - 2016-08-14T18:40:00+00:00 + 2016-08-14T19:29:35+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-info.html - 2016-08-14T18:40:00+00:00 + 2016-08-14T19:29:35+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-service.html - 2016-08-14T18:40:00+00:00 + 2016-08-14T19:29:35+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-state.html - 2016-08-14T18:40:00+00:00 + 2016-08-14T19:29:35+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-template.html - 2016-08-14T18:40:00+00:00 + 2016-08-14T19:29:35+00:00 https://home-assistant.io/demo/panels/ha-panel-history.html - 2016-08-14T18:40:00+00:00 + 2016-08-14T19:29:35+00:00 https://home-assistant.io/demo/panels/ha-panel-iframe.html - 2016-08-14T18:40:00+00:00 + 2016-08-14T19:29:35+00:00 https://home-assistant.io/demo/panels/ha-panel-logbook.html - 2016-08-14T18:40:00+00:00 + 2016-08-14T19:29:35+00:00 https://home-assistant.io/demo/panels/ha-panel-map.html - 2016-08-14T18:40:00+00:00 + 2016-08-14T19:29:35+00:00 https://home-assistant.io/googlef4f3693c209fe788.html - 2016-08-14T18:40:00+00:00 + 2016-08-14T19:29:35+00:00 https://home-assistant.io/static/fonts/roboto/DESCRIPTION.en_us.html - 2016-08-14T18:40:00+00:00 + 2016-08-14T19:29:35+00:00 https://home-assistant.io/static/fonts/robotomono/DESCRIPTION.en_us.html - 2016-08-14T18:40:00+00:00 + 2016-08-14T19:29:35+00:00 https://home-assistant.io/static/mdi-demo.html - 2016-08-14T18:40:00+00:00 + 2016-08-14T19:29:35+00:00