Configuration.yaml: reword intro, add screenshot, move troubleshootin… (#32474)

* Configuration.yaml: reword intro, add screenshot, move troubleshooting section

* Shorten intro
This commit is contained in:
c0ffeeca7 2024-04-26 14:17:52 +02:00 committed by GitHub
parent 29c320b323
commit 7f874a2d93
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 11 additions and 2 deletions

View File

@ -12,11 +12,16 @@ related:
title: Creating backups for Home Assistant Container and Core
- docs: /docs/tools/dev-tools/#reloading-the-yaml-configuration
title: Reloading the YAML configuration from developer tools
- docs: docs/configuration/troubleshooting/
title: Troubleshooting the configuration
---
While you can configure most of Home Assistant directly from the user interface under {% my config %}, some parts need you to edit `configuration.yaml`. This file contains {% term integrations %} to be loaded along with their configurations. Throughout the documentation you will find snippets that you can add to your configuration file to enable specific functionality.
While you can configure most of Home Assistant from the user interface, for some integrations, you need to edit the `configuration.yaml` file. This file contains {% term integrations %} to be loaded along with their configurations. Throughout the documentation, you will find snippets that you can add to your configuration file to enable specific functionality.
If you run into trouble while configuring Home Assistant, refer to the [configuration troubleshooting page](/docs/configuration/troubleshooting/) and the [`configuration.yaml` examples](/examples/#example-configurationyaml).
<p class='img'>
<img src='/images/docs/configuration/config-yaml_via-file-editor.png' alt='Screenshot of an example of a configuration.yaml file, accessed using the File editor add-on on a Home Assistant Operating System installation.'>
Example of a configuration.yaml file, accessed using the File editor add-on on a Home Assistant Operating System installation.
</p>
## Editing `configuration.yaml`
@ -61,3 +66,7 @@ For configuration changes to become effective, the configuration must be reloade
- Note: This interrupts automations and scripts.
![Reload and restart buttons](/images/docs/configuration/reload_restart.png)
## Troubleshooting the configuration
If you run into trouble while configuring Home Assistant, refer to the [configuration troubleshooting page](/docs/configuration/troubleshooting/) and the [`configuration.yaml` examples](/examples/#example-configurationyaml).

Binary file not shown.

After

Width:  |  Height:  |  Size: 96 KiB