Skip to content

docs: fix instructions for disabling systemd-resolved port 53 for fedora (still compatible with Ubuntu) - #1860

Closed
LizenzFass78851 wants to merge 1 commit into
pi-hole:developmentfrom
LizenzFass78851:docs/systemd-resolve
Closed

docs: fix instructions for disabling systemd-resolved port 53 for fedora (still compatible with Ubuntu)#1860
LizenzFass78851 wants to merge 1 commit into
pi-hole:developmentfrom
LizenzFass78851:docs/systemd-resolve

Conversation

@LizenzFass78851

@LizenzFass78851 LizenzFass78851 commented Jul 6, 2025

Copy link
Copy Markdown
Contributor

Description

This supplements the instructions for deactivating systemctl resolve port 53 under Fedora, since one of the previous commands only works under Ubuntu (Debian).

Motivation and Context

How Has This Been Tested?

I created 4 VMs:

  • Fedora 33
  • Fedora 42
  • Ubuntu 18.04
  • Ubuntu 24.04

I tried the instructions for disabling systemd-resolve in all 4 VMs and found that, following the previous instructions, this no longer worked on Fedora 42. However, it did work on the other 3 VMs (as also noted in the linked issue).

After updating the documentation (readme.md), I tried the additions on Fedora 42 (and Fedora 33), port 53 was successfully disabled.

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)

Checklist:

  • My code follows the code style of this project.
  • My change requires a change to the documentation.
  • I have updated the documentation accordingly.

@LizenzFass78851
LizenzFass78851 requested a review from a team as a code owner July 6, 2025 11:52
@LizenzFass78851 LizenzFass78851 changed the title docs: Add instructions for disabling resolved port 53 for fedora docs: Add instructions for disabling systemd-resolved port 53 for fedora Jul 6, 2025
@LizenzFass78851 LizenzFass78851 changed the title docs: Add instructions for disabling systemd-resolved port 53 for fedora docs: fix instructions for disabling systemd-resolved port 53 for fedora (still compatible with Ubuntu) Jul 10, 2025
Troubleshooting for Fedora. It is Ubuntu compatible.

Signed-off-by: LizenzFass78851 <82592556+LizenzFass78851@users.noreply.github.com>

@yubiuser yubiuser left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I still think all this configurations is better placed in https://docs.pi-hole.net/docker/

Comment thread README.md
Comment thread README.md

For fedora users, you can run the following commands to edit the sysconfig(s) found at `/etc/NetworkManager/system-connections` via nmcli.

Example sysconfig nmcli commands:

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure if we should have instructions how to set Pi-hole as the DNS for the host at all. While this is a valid configurations, the host's DNS will break if Pi-hole is not running.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For Ubuntu's netplan, there is already a similar example of how to use Pihole as a system DNS server in the operating system:

docker-pi-hole/README.md

Lines 195 to 209 in ee0d04f

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`.
Example netplan:
```yaml
network:
ethernets:
ens160:
dhcp4: true
dhcp4-overrides:
use-dns: false
nameservers:
addresses: [127.0.0.1]
version: 2
```

Therefore, the additionall instructions for set Pihole as a DNS server for the operating system for Fedora users.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I see where you'e coming from. This is a more general discussion. (I think I meant to suggest to also move the Ubuntu part to the docs). Maybe @pi-hole/docker-maintainers have an opinion

@yubiuser

Copy link
Copy Markdown
Member

Doc PR moving this to the other repo: pi-hole/docs#1266

I thin we can remove the whole section then and only leave a link.

@LizenzFass78851

Copy link
Copy Markdown
Contributor Author

I thin we can remove the whole section then and only leave a link.

The pr #1863 to remove the section has been created

@github-actions

Copy link
Copy Markdown

This pull request has conflicts, please resolve those before we can evaluate the pull request.

@yubiuser

Copy link
Copy Markdown
Member

#1863 has been merged.

@yubiuser yubiuser closed this Jul 13, 2025
@LizenzFass78851
LizenzFass78851 deleted the docs/systemd-resolve branch July 14, 2025 04:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants