mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-21 08:16:53 +00:00
Add unsupported help for dns server issue (#22516)
This commit is contained in:
parent
6fbd8f8baa
commit
d616f206aa
58
source/more-info/unsupported/dns_server.markdown
Normal file
58
source/more-info/unsupported/dns_server.markdown
Normal file
@ -0,0 +1,58 @@
|
||||
---
|
||||
title: "DNS server issues"
|
||||
description: "More information on why issues with a DNS server marks the installation as unsupported."
|
||||
---
|
||||
|
||||
## The issue
|
||||
|
||||
Home Assistant requires a working DNS server to function. Without one it may be
|
||||
unable to provide functionality like checking and executing updates, showing
|
||||
documentation, reach external services required by add-ons and integrations, etc.
|
||||
|
||||
## The solution
|
||||
|
||||
The easiest solution is to re-enable the fallback DNS option by executing the following
|
||||
command in the CLI:
|
||||
|
||||
```sh
|
||||
ha dns options --fallback=true
|
||||
```
|
||||
|
||||
Alternatively review your system issues by executing the following command in the
|
||||
CLI:
|
||||
|
||||
```sh
|
||||
ha resolution info
|
||||
```
|
||||
|
||||
You will see one or more issues with a context of `dns_server`. For each such issue,
|
||||
take the following actions based on the issue type.
|
||||
|
||||
### `dns_server_failed`
|
||||
|
||||
1. Ensure the DNS server is operating normally
|
||||
2. Ensure the DNS server has internet access
|
||||
3. Ensure the hostname `_checkdns.home-assistant.io` is not blocked
|
||||
|
||||
### `dns_server_ipv6_error`
|
||||
|
||||
If you see this that means the application you are using for DNS is not handling
|
||||
A and AAAA requests correctly. You can test this by executing the following commands:
|
||||
|
||||
```sh
|
||||
server="<IP address of DNS server>"
|
||||
dig "@$server" _checkdns.home-assistant.io +noall +comments +answer A
|
||||
dig "@$server" _checkdns.home-assistant.io +noall +comments +answer AAAA
|
||||
```
|
||||
|
||||
A DNS server handling A and AAAA requests correctly will respond with status `NOERROR`
|
||||
for both of those queries even though there are no answers for the AAAA request.
|
||||
A DNS server mishandling this request will only return a `NOERROR` response for
|
||||
the first one and will return `NXDOMAIN`, `REFUSED`, `SERVFAIL` or some other error
|
||||
status for the second.
|
||||
|
||||
It is important to use a DNS server that handles this situation correctly since
|
||||
Home Assistant uses alpine for many of its containers. Alpine follows the DNS spec
|
||||
and will treat the entire domain as if it can't be resolved if it receives an error
|
||||
status for either query. Home Assistant will run into many unexpected issues in
|
||||
this situation, particularly around updates and installing software.
|
Loading…
x
Reference in New Issue
Block a user