From 7f874a2d9306e3472a2a073208095a875d7ecfa5 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Fri, 26 Apr 2024 14:17:52 +0200 Subject: [PATCH] =?UTF-8?q?Configuration.yaml:=20reword=20intro,=20add=20s?= =?UTF-8?q?creenshot,=20move=20troubleshootin=E2=80=A6=20(#32474)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Configuration.yaml: reword intro, add screenshot, move troubleshooting section * Shorten intro --- source/_docs/configuration.markdown | 13 +++++++++++-- .../config-yaml_via-file-editor.png | Bin 0 -> 98035 bytes 2 files changed, 11 insertions(+), 2 deletions(-) create mode 100644 source/images/docs/configuration/config-yaml_via-file-editor.png diff --git a/source/_docs/configuration.markdown b/source/_docs/configuration.markdown index 1a13dbca13b..2e58c82e439 100644 --- a/source/_docs/configuration.markdown +++ b/source/_docs/configuration.markdown @@ -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). +
+
+Example of a configuration.yaml file, accessed using the File editor add-on on a Home Assistant Operating System installation.
+
z!%*b!JG0_{7SdA*}XVIYAbewxg0ZcdW>*1uF
zxhhAq_|kHR?kS}Q-mbwqa|1U7P)~OBb$^s`>h+FwCClx)r+i+o3aw0eF5mS{!pVy!
z$}c6~`hlzK(iJ*cxo+eBeEMA?q7q*#4kIZ63CB+P&@jWbw~`;%s%fIOe})Wnl$zW2
zM$g}nyFZ*Zk=p9z&Be83Gra0N6329x9E<(|6O*Dr9v^FqIPq;}#=RE&6+Ux3F%Hrr
z%Q9=y%|KOQ4kHfI7S||Oc62H6%*j0*(g+4E8}7DRosiVKI0U-(dJE0Jf)#>#SD%_C
z=e`Z=BGBXn16mefK*yg8h70x8%k$VxzS(a-*=|!dd2jz?r$}|xeiuYub~L%i^!o$O
zxVZfM{3I-V#ocDge6 SI2%FRzu+sK_7Q-
zcFOiwYGR^#j(71_;~m`4q?D<=D>Y*(tfuCO#l*Gv?BKTvaGpIG2iSs&oqfL?4PY|?
z1a1PF25IFQt}glD02vt>NvZ>Idj;}q;nvT}&c>?KE3CbVjorU~2%jAEi-83NPXVp?
zH8z$4?fw9Sy~2B%HS$r&FCDlrKjRw;4ePpjlemL
zn8mBycPWuTSnvaX_PzKA#aRhBugh&GWn^S-de)^w=`**!4)=*}JJ?l#D-xHKRB7<_
zNnp|q1r`NhVz{+PIW5JZXN1ERD0CQYCJ(M|$USXtY6^s}!j_YR&qxE929TlfAO2N^
zcOmBEM@6XGKwEoqcE-T|eVdxIYA9FX8x;gI%6S0)2H6uoJ3DhH9@4!emDcFc5Uq?7
zYGPpDwE$TVxO5WEdQTuReg@=n0-9Y_smsO?Tm-b(BH*^4zkE^F(UF7u2i_1y&En79
zxAcB~0I7=#lxu(i#Y^+AsoRJFP#3f|A1Sm8Fn^952H?P7M?d4GDSYD(H1s^$v2_Q5
zF&z^V%sP0*Lb3uBjnLIOJDe$u!+Kf$cz5nJ0n@VR(c%^K)1VO=dpNN4+-I+ahK2P=
z<^wzPjKKcqeQ-J4ym_-*Qq{7b<**P4TiTZ?1+TQ!EVm}AIvw5qzg7!*c4<8F^iza~l>%ZqA1s9ihaUG8oB
zG=H6-{&tO(pV5Tg%kt$a#q12d>hAUFbmn6MSa}D@7N+H^0QSDKuFBFL$g4(zf#G4`
zLr_sNklXSD+yM$65`K3UfDoP>%jUxaB4dpJYm0>>!{l%2o}tihAh{Nhz6y&Nf+N&_
zyK`a{NLz=6bxF76U@tzHCRyBEr};S$yt`I`|NesE zV>x_p(>
zY;(~!(;{0scAt&M)j@ZWA?{}X(s!8+?iY-)(anvvY{jYgk9j43WYlk)nnR~+#j8aL
zX5Vih5h0p=-Y+*ae2Ru4zl&IF@v?D9OIJ!TuWOQI?)m-HafNRW%z|GOW?rmpIz-tn
zO`^KG@w=q7dfBPwCq={gq%V%75mJwhM2w@UouP=LnL+bjU9?8Y-b;2iB0jg_5xm2m
zuTeN-_R(0Uck?D{&(IonsBbTc4x^Gi+nPh_T$)s+Dar5Y)iq<8Y0=iynIx^#vl5k`
z9z6NSz|f~E2(=!|mj_HKelaKRrmKVEj9;Ut{oW7qDED^isdz!JVsu*?5s|kp1lfDx
z;bWhBs~t8?mzGc{MIN5!GQNqZ#kH|@d2ElCf7iI3nG>JM$1{Iopp-vx(nw|{A?kEP
z+;_Rb4ewC#;>tH5K?(O*&tfkfVc1A9D9s-kJ_uvBRc>ppk4n+XO$`lUHZ=IM?rW>1
zI{L$-sacsXi+g3h+6p3Yt|R0Jz!(`gT1*Z49zW6@L!oT_u2q+ot=Bpvdk7Xxe6+4v
zQZ}Wh?G_Q%Vs4o$Yk14A`_`}!Cu&J)c1dC_&q}Pz7A+(!eA9I2u7T3^fw4kO8wqsB
zUygN=ukhz7w#Eee*M;kS-YKkpNKDl>Zz6kEF&qd>w^LV#bnl*^l+jO(+@uY~y-M3*
z+5VZa0>5c&6%n_pGc*h@qlKTS`@nVj*cmB&+wIVZcim~p$);pa<8%rzs9_YUP}t6?
zK%swB5K2qUs+YPNE0%vk404p*O{q#6);2ac>90#V0JY<7Fq_9ovF%LtmlP>l5S;Lr
zRH~Du9|_&$7BCEt;aWX0VZ-*cc7GP%Y0q!K1wEd;`#7PEe3IGAu^<0dUcTxmidMu9
ziF3Fs-%~#%yCM&bAFc{v*ZM!
YDAUu^?+bcY
zwys}**g?}`oTz8R;%{Gq;?%Z+(>KpjTg{LEj$BZaE~ORcqbin;G=|HJC;0r@#>R?&
z)u%c*^K3}3{bjwmXcnszzo{K)(KEkE_R2!@?UKS_ww+zi!mfb%L_2qlhj+-Q)HRhe
z@BEiO8`cFZt4BqKOE!u3{@`-O`v!e0&5k5{771LFx)DHVw|L%de