DNS server issues
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:
ha dns options --fallback=true
Alternatively review your system issues by executing the following command in the CLI:
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
- Ensure the DNS server is operating normally
- Ensure the DNS server has internet access
- Ensure the hostname
_checkdns.home-assistant.iois 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:
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.