You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: source/more-info/unsupported/dns_server.markdown
+8-22Lines changed: 8 additions & 22 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,28 +5,23 @@ description: "More information on why issues with a DNS server marks the install
5
5
6
6
## The issue
7
7
8
-
Home Assistant requires a working DNS server to function. Without one it may be
9
-
unable to provide functionality like checking and executing updates, showing
10
-
documentation, reach external services required by add-ons and integrations, etc.
8
+
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, reaching external services required by add-ons and integrations, and other tasks that depend on internet access.
11
9
12
10
## The solution
13
11
14
-
The easiest solution is to re-enable the fallback DNS option by executing the following
15
-
command in the CLI:
12
+
The easiest solution is to re-enable the fallback DNS option by executing the following command in the CLI:
16
13
17
14
```sh
18
15
ha dns options --fallback=true
19
16
```
20
17
21
-
Alternatively review your system issues by executing the following command in the
22
-
CLI:
18
+
Alternatively review your system issues by executing the following command in the CLI:
23
19
24
20
```sh
25
21
ha resolution info
26
22
```
27
23
28
-
You will see one or more issues with a context of `dns_server`. For each such issue,
29
-
take the following actions based on the issue type.
24
+
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.
30
25
31
26
### `dns_server_failed`
32
27
@@ -36,23 +31,14 @@ take the following actions based on the issue type.
36
31
37
32
### `dns_server_ipv6_error`
38
33
39
-
If you see this that means the application you are using for DNS is not handling
40
-
A and AAAA requests correctly. You can test this by executing the following commands:
34
+
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:
41
35
42
36
```sh
43
37
server="<IP address of DNS server>"
44
38
dig "@$server" _checkdns.home-assistant.io +noall +comments +answer A
A DNS server handling A and AAAA requests correctly will respond with status `NOERROR`
49
-
for both of those queries even though there are no answers for the AAAA request.
50
-
A DNS server mishandling this request will only return a `NOERROR` response for
51
-
the first one and will return `NXDOMAIN`, `REFUSED`, `SERVFAIL` or some other error
52
-
status for the second.
53
-
54
-
It is important to use a DNS server that handles this situation correctly since
55
-
Home Assistant uses alpine for many of its containers. Alpine follows the DNS spec
56
-
and will treat the entire domain as if it can't be resolved if it receives an error
57
-
status for either query. Home Assistant will run into many unexpected issues in
58
-
this situation, particularly around updates and installing software.
42
+
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.
43
+
44
+
It is important to use a DNS server that handles this situation correctly since Home Assistant uses Alpine Linux 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.
0 commit comments