Skip to content

Commit cde1cc2

Browse files
authored
Merge pull request #1863 from LizenzFass78851/docs/systemd-resolve-2
docs: remove part of tips & tricks and add a link to the docs
2 parents f306857 + 356d1ba commit cde1cc2

File tree

1 file changed

+2
-30
lines changed

1 file changed

+2
-30
lines changed

README.md

Lines changed: 2 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -183,36 +183,8 @@ Here is a rundown of other arguments for your docker-compose / docker run.
183183
- Docker's default network mode `bridge` isolates the container from the host's network. This is a more secure setting, but requires setting the Pi-hole DNS option for _Interface listening behavior_ to "Listen on all interfaces, permit all origins".
184184
- If you're using a Red Hat based distribution with an SELinux Enforcing policy, add `:z` to line with volumes.
185185

186-
### Installing on Ubuntu or Fedora
187-
188-
Modern releases of Ubuntu (17.10+) and Fedora (33+) include [`systemd-resolved`](http://manpages.ubuntu.com/manpages/bionic/man8/systemd-resolved.service.8.html) which is configured by default to implement a caching DNS stub resolver. This will prevent pi-hole from listening on port 53.
189-
The stub resolver should be disabled with: `sudo sed -r -i.orig 's/#?DNSStubListener=yes/DNSStubListener=no/g' /etc/systemd/resolved.conf`.
190-
191-
This will not change the nameserver settings, which point to the stub resolver thus preventing DNS resolution. Change the `/etc/resolv.conf` symlink to point to `/run/systemd/resolve/resolv.conf`, which is automatically updated to follow the system's [`netplan`](https://netplan.io/):
192-
`sudo sh -c 'rm /etc/resolv.conf && ln -s /run/systemd/resolve/resolv.conf /etc/resolv.conf'`.
193-
After making these changes, you should restart systemd-resolved using `systemctl restart systemd-resolved`.
194-
195-
Once pi-hole is installed, you'll want to configure your clients to use it ([see here](https://discourse.pi-hole.net/t/how-do-i-configure-my-devices-to-use-pi-hole-as-their-dns-server/245)). If you used the symlink above, your docker host will either use whatever is served by DHCP, or whatever static setting you've configured. If you want to explicitly set your docker host's nameservers you can edit the netplan(s) found at `/etc/netplan`, then run `sudo netplan apply`.
196-
197-
Example netplan:
198-
199-
```yaml
200-
network:
201-
ethernets:
202-
ens160:
203-
dhcp4: true
204-
dhcp4-overrides:
205-
use-dns: false
206-
nameservers:
207-
addresses: [127.0.0.1]
208-
version: 2
209-
```
210-
211-
Note that it is also possible to disable `systemd-resolved` entirely. However, this can cause problems with name resolution in vpns ([see bug report](https://bugs.launchpad.net/network-manager/+bug/1624317)).\
212-
It also disables the functionality of netplan since systemd-resolved is used as the default renderer ([see `man netplan`](http://manpages.ubuntu.com/manpages/bionic/man5/netplan.5.html#description)).\
213-
If you choose to disable the service, you will need to manually set the nameservers, for example by creating a new `/etc/resolv.conf`.
214-
215-
Users of older Ubuntu releases (circa 17.04) will need to disable dnsmasq.
186+
> [!TIP]
187+
> All further tips and tricks can be found in the [Pi-hole documentation](https://docs.pi-hole.net/docker/tips-and-tricks/)
216188

217189
## Installing on Dokku
218190

0 commit comments

Comments
 (0)