mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-21 08:16:53 +00:00
Add more-info about unhealthy setups (#15729)
Co-authored-by: Franck Nijhof <git@frenck.dev>
This commit is contained in:
parent
9dfb326aa2
commit
3e05425e56
13
source/more-info/unhealthy/docker.markdown
Normal file
13
source/more-info/unhealthy/docker.markdown
Normal file
@ -0,0 +1,13 @@
|
||||
---
|
||||
title: "The Docker environment is not working properly"
|
||||
description: "More information on why a misconfigured Docker environment marks the system as unhealthy."
|
||||
---
|
||||
|
||||
Docker is at the core of most operations that the Supervisor does, it is important that it is configured properly and is working the way the Supervisor expects.
|
||||
|
||||
The Supervisor will be marked as unhealthy if any of these requirements are not met:
|
||||
|
||||
- [Running containers known to cause issues](/more-info/unsupported/container)
|
||||
- [Running an unsupported Docker version](/more-info/unsupported/docker_version)
|
||||
- [Running the Supervisor under LXC](/more-info/unsupported/lxc)
|
||||
- [Not running the Supervisor as privileged](/more-info/unsupported/privileged)
|
29
source/more-info/unhealthy/setup.markdown
Normal file
29
source/more-info/unhealthy/setup.markdown
Normal file
@ -0,0 +1,29 @@
|
||||
---
|
||||
title: "Setup of the Supervisor failed"
|
||||
description: "More information on why failing the setup stage makes an installation as unhealthy."
|
||||
---
|
||||
|
||||
## The issue
|
||||
|
||||
This happens when any of the setup tasks fails to complete, this can be due to the host not being completely ready when the Supervisor starts or that [DBUS] is not properly working.
|
||||
|
||||
## The solution
|
||||
|
||||
If the issue is related to DBUS, you will see an unsupported message about that as well; You can have a look [here][DBUS] on how to resolve that.
|
||||
|
||||
The first thing you should try is to restart the Supervisor.
|
||||
This can be done from the "System" tab in the Supervisor panel. On the card for "Supervisor", there is a button to restart the Supervisor.
|
||||
|
||||
This can also be done with the CLI, by running the following command:
|
||||
|
||||
```bash
|
||||
ha supervisor restart
|
||||
```
|
||||
|
||||
|
||||
If this does not help, you can try to reboot the host.
|
||||
If you are running Home Assistant Operating System, this can be done from the "System" tab in the Supervisor panel. On the card for "Host System", there is a button to reboot the host.
|
||||
|
||||
To help us make the setup more robust, please enable the sharing of diagnostics and crash logs on the "System" tab in the Supervisor panel.
|
||||
|
||||
[DBUS]: /more-info/unsupported/dbus
|
17
source/more-info/unhealthy/supervisor.markdown
Normal file
17
source/more-info/unhealthy/supervisor.markdown
Normal file
@ -0,0 +1,17 @@
|
||||
---
|
||||
title: "Supervisor was not able to update"
|
||||
description: "More information on why a failed Supervisor update marks a system as unhealthy."
|
||||
---
|
||||
|
||||
## The issue
|
||||
|
||||
This can happen when there was a network issue during the startup of the Supervisor.
|
||||
|
||||
## The solution
|
||||
|
||||
Manually update the Supervisor. This can be done from the "System" tab in the Supervisor panel. On the card for "Supervisor", there is a button to update the Supervisor.
|
||||
|
||||
This can also be done with the CLI, by running the following command:
|
||||
```bash
|
||||
ha supervisor update
|
||||
```
|
Loading…
x
Reference in New Issue
Block a user