Add more-info about unhealthy setups (#15729)

Co-authored-by: Franck Nijhof <git@frenck.dev>
This commit is contained in:
Joakim Sørensen 2020-11-23 17:37:26 +01:00 committed by GitHub
parent 9dfb326aa2
commit 3e05425e56
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 59 additions and 0 deletions

View 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)

View 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

View 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
```