1.6 KiB
layout, title, description, date, sidebar, comments, sharing, footer
| layout | title | description | date | sidebar | comments | sharing | footer |
|---|---|---|---|---|---|---|---|
| page | Configuring Home Assistant | Configuring Home Assistant. | 2015-03-23 12:50 | true | false | true | true |
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.
The location of the folder differs between operating systems:
| OS | Path |
|---|---|
| OS X | ~/.homeassistant |
| Linux | ~/.homeassistant |
| Windows | %APPDATA%/.homeassistant |
If you want to use a different folder for configuration, use the config command line parameter: hass --config path/to/config.
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 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.