From 6d24b54dca074504873c6f9c9fe3672c22692750 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Kamil=20Bregu=C5=82a?= Date: Mon, 17 Nov 2025 08:32:14 +0100 Subject: [PATCH] Enhance Safe mode instructions in troubleshooting guide (#41769) --- source/_docs/troubleshooting_general.markdown | 16 +++++++++++++--- 1 file changed, 13 insertions(+), 3 deletions(-) diff --git a/source/_docs/troubleshooting_general.markdown b/source/_docs/troubleshooting_general.markdown index cb5c31f0446..f125c03a285 100644 --- a/source/_docs/troubleshooting_general.markdown +++ b/source/_docs/troubleshooting_general.markdown @@ -43,9 +43,19 @@ You need to identify the issue in the configuration files and fix it there. The If your Home Assistant is acting up and you cannot identify a root cause, you can use **Safe mode** to narrow down the number of possible causes. **Safe mode** loads Home Assistant Core, but no custom integrations, no custom cards, and no custom themes. If the issue does not persist in **Safe mode**, the issue is not with Home Assistant Core. Before reporting an issue, check if the issue persists in **Safe mode**. -- To enable Safe mode from the UI, go to **Settings** > **System** > **Restart Home Assistant** (top right) > **Restart Home Assistant in safe mode**. -- If you cannot reach the UI, you can enable **Safe mode** from the [command line](/common-tasks/os/#home-assistant-via-the-command-line): - - ```ha core restart --safe-mode``` +You can enable Safe mode in several ways: + +- From the UI: + - Go to **Settings** > **System** > **Restart Home Assistant** (top right) > **Restart Home Assistant in safe mode**. + +- From the [command line](/common-tasks/os/#home-assistant-via-the-command-line): + - Run: + ```bash + ha core restart --safe-mode + ``` + +- By creating a file in the configuration directory: + - Create an empty file named `safe-mode` in your Home Assistant configuration directory. Home Assistant will detect this file on startup and automatically boot into Safe mode. ## I don't see any updates