Enhance Safe mode instructions in troubleshooting guide #41769
Conversation
Added additional methods to enable Safe mode in Home Assistant documentation.
✅ Deploy Preview for home-assistant-docs ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
Added instructions for enabling Safe mode in Home Assistant.
Reformat instructions for enabling Safe mode in Home Assistant.
There was a problem hiding this comment.
Pull Request Overview
This PR enhances the Safe mode instructions in the troubleshooting documentation by adding a third method to enable Safe mode - creating a file in the configuration directory. This addition is particularly useful for users running Home Assistant in container environments where file creation may be simpler than using the UI or command line.
Key changes
- Restructured the Safe mode section to list three methods instead of two
- Added instructions for enabling Safe mode by creating a
safe-modefile in the configuration directory - Reorganized the existing UI and command line methods into a clearer bullet list format
| - 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: ```ha core restart --safe-mode``` |
There was a problem hiding this comment.
The inline code block for the command should use a proper fenced code block with the language specified instead of inline backticks. According to the documentation standards, when using code blocks, it is required to specify the language for syntax highlighting.
Change from:
- Run: ```ha core restart --safe-mode```
To:
- Run the following command:
```bash
ha core restart --safe-mode
| - 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. |
There was a problem hiding this comment.
The continuation of the description across line 56 should be on the same line as the previous line. According to the documentation standards, there is no line length limit and content should be written in a flowing text style. Multi-line text in list items should either be written as flowing text or properly separated with blank lines if it represents separate paragraphs.
Change from:
- 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.
To:
- 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.
Updated command line instructions for restarting Home Assistant in safe mode to improve formatting and clarity.
Added additional methods to enable Safe mode in Home Assistant documentation.
Proposed change
Related: home-assistant/core#156486
If someone uses HA as a container, creating a file is the simplest method.
Type of change
currentbranch).currentbranch).nextbranch).nextbranch).Additional information
Checklist
currentbranch.nextbranch.