From ffda0b63aa293acf5b7740d27a0fb9d0b51eb154 Mon Sep 17 00:00:00 2001 From: Laszlo Magyar Date: Wed, 5 Feb 2025 01:01:34 +0100 Subject: [PATCH 1/2] warn users about the UI bug --- tailscale/DOCS.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/tailscale/DOCS.md b/tailscale/DOCS.md index a9e1f3fd5..137251fcf 100644 --- a/tailscale/DOCS.md +++ b/tailscale/DOCS.md @@ -84,6 +84,25 @@ userspace_networking: true > change them through the Web UI, because all the changes made there would be > lost when the add-on is restarted. +> [!CAUTION] +> Due to limitations in Home Assistant's UI, **do not use** the "Show unused +> optional configuration options" switch on the Configuration tab! + +> [!CAUTION] +> When you want to change the default behaviour of any of these optional +> configuration options, **add them to the YAML add-on configuration manually**, +> by using the "Edit in YAML" in the ... menu on the right and save them! Use +> the UI to edit them only after you added them manually! + +> [!WARNING] +> Home Assistant's UI will show you all the optional configuration options +> turned off instead of grayed out, and you will falsely believe that those are +> the values that will be stored, so you will enable options, that by default +> are already enabled when unused, and you will let options be disabled, that +> you originally wanted to disable, but the **UI will not add these disabled +> optional configuration options** to the YAML add-on configuration, and at the +> end nothing will change in the add-on's functionality after a restart! + ### Option: `accept_dns` If you are experiencing trouble with MagicDNS on this device and wish to From 401127d9a376c608a2e5fc52dc03dbebf277cffe Mon Sep 17 00:00:00 2001 From: Laszlo Magyar Date: Wed, 5 Feb 2025 03:06:06 +0100 Subject: [PATCH 2/2] fix grammar in UI bug --- tailscale/DOCS.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/tailscale/DOCS.md b/tailscale/DOCS.md index 137251fcf..a837fec6f 100644 --- a/tailscale/DOCS.md +++ b/tailscale/DOCS.md @@ -89,17 +89,17 @@ userspace_networking: true > optional configuration options" switch on the Configuration tab! > [!CAUTION] -> When you want to change the default behaviour of any of these optional -> configuration options, **add them to the YAML add-on configuration manually**, -> by using the "Edit in YAML" in the ... menu on the right and save them! Use -> the UI to edit them only after you added them manually! +> When you want to change the default behaviour of these optional configuration +> options, **add them to the YAML add-on configuration manually**, by using the +> "Edit in YAML" in the ... menu on the right and save them! Use the UI to edit +> them only after you added them manually! > [!WARNING] > Home Assistant's UI will show you all the optional configuration options -> turned off instead of grayed out, and you will falsely believe that those are -> the values that will be stored, so you will enable options, that by default -> are already enabled when unused, and you will let options be disabled, that -> you originally wanted to disable, but the **UI will not add these disabled +> turned off instead of grayed out. You will falsely believe that those are the +> values that will be stored, so you will enable options, that by default are +> already enabled when unused, and you will let options be disabled, that you +> originally wanted to disable. But the **UI will not add these disabled > optional configuration options** to the YAML add-on configuration, and at the > end nothing will change in the add-on's functionality after a restart!