From 2bf1f8b0a3fc8379e33eb532df89d7591a3f898b Mon Sep 17 00:00:00 2001
From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Date: Wed, 15 May 2024 11:31:59 +0200
Subject: [PATCH] Troubleshooting: restart in safe mode from cmd (#32789)

---
 source/_docs/troubleshooting_general.markdown | 9 +++++++--
 source/_includes/common-tasks/commandline.md  | 1 +
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/source/_docs/troubleshooting_general.markdown b/source/_docs/troubleshooting_general.markdown
index 9180465edbd..859adac0b23 100644
--- a/source/_docs/troubleshooting_general.markdown
+++ b/source/_docs/troubleshooting_general.markdown
@@ -8,6 +8,8 @@ related:
     title: Recovery mode integration
   - docs: /docs/locked_out/
     title: Resetting your password
+  - docs: /common-tasks/os/#home-assistant-via-the-command-line
+    title: Home Assistant via command line
 ---
 
 This page provides some information about more generic troubleshooting topics.
@@ -39,6 +41,9 @@ You need to identify the issue in the configuration files and fix it there. The
 ## Restarting Home Assistant in safe mode
 
 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.
+**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```
 
-To enable Safe mode, go to **Settings** > **System** > **Restart Home Assistant** (top right) > **Restart Home Assistant in safe mode**.
diff --git a/source/_includes/common-tasks/commandline.md b/source/_includes/common-tasks/commandline.md
index 8505c66f962..322597c4eec 100644
--- a/source/_includes/common-tasks/commandline.md
+++ b/source/_includes/common-tasks/commandline.md
@@ -11,6 +11,7 @@ ha core logs
 ha core options
 ha core rebuild
 ha core restart
+ha core restart --safe-mode
 ha core start
 ha core stats
 ha core stop