Skip to content

Commit 7b794b4

Browse files
committed
DOC-3595 RS: Prevent dnsmasq from using port 53
1 parent d1edd01 commit 7b794b4

File tree

1 file changed

+29
-1
lines changed

1 file changed

+29
-1
lines changed

content/embeds/port-53.md

Lines changed: 29 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,9 @@
1-
If port 53 is in use, the installation fails. This issue can occur in default installations of certain operating systems in which `systemd-resolved` (DNS server) is running.
1+
If port 53 is in use, the installation fails. This issue can occur in default installations of certain operating systems in which `systemd-resolved` (DNS server) or `dnsmasq` is running.
22

33
To prevent this issue, change the system configuration to make this port available before installation.
44

5+
To prevent `systemd-resolved` from using port 53:
6+
57
1. Edit `/etc/systemd/resolved.conf`:
68

79
```sh
@@ -31,3 +33,29 @@ You might encounter a temporary name resolution error (`sudo: unable to resolve
3133
```sh
3234
sudo service systemd-resolved restart
3335
```
36+
37+
To prevent `dnsmasq` from using port 53:
38+
39+
1. Stop the `dnsmasq` service if it's running:
40+
41+
```sh
42+
sudo systemctl stop dnsmasq
43+
```
44+
45+
1. Prevent `dnsmasq` from starting automatically at system boot:
46+
47+
```sh
48+
sudo systemctl disable dnsmasq
49+
```
50+
51+
1. Mask `dnsmasq` to prevent it from being started manually or by other services:
52+
53+
```sh
54+
sudo systemctl mask dnsmasq
55+
```
56+
57+
1. Verify `dnsmasq` is no longer active and won't start at system boot:
58+
59+
```sh
60+
sudo systemctl status dnsmasq
61+
```

0 commit comments

Comments
 (0)