Add mDNS article #201

Merged
pboy merged 2 commits from brettweir/user-documentation:add-mdns-article into main 2026-07-17 08:33:06 +00:00
Member

This PR is a revised version of the write-up I did about mDNS as part of setting up a Raspberry Pi home server. I thought this might better serve as an article in the main server documentation.

This PR is a revised version of the write-up I did about mDNS as part of setting up a Raspberry Pi home server. I thought this might better serve as an article in the main server documentation.
Assisted-by: Pi:gpt-oss-120b
goroboro approved these changes 2026-07-16 10:46:19 +00:00
goroboro left a comment

All good, but I included some comments that might help improve this topic.

All good, but I included some comments that might help improve this topic.
@ -0,0 +4,4 @@
In this guide, we walk through making your server available by name on your local network via mDNS.
This is useful in small networks, homelabs, or any other environment where clients exist on the same subnet as the server.
Member

Maybe expand this to note that if you have more complex networking like bridges for virtual machine networks or VLANs or multiple interfaces connected to different networks, you probably want to explore alternate DNS services, like DDNS etc.

Maybe expand this to note that if you have more complex networking like bridges for virtual machine networks or VLANs or multiple interfaces connected to different networks, you probably want to explore alternate DNS services, like DDNS etc.
Author
Member

I think this is good feedback, but I will leave it off for now, because I don't have a clear action in mind that they can take as a result of it, so it distracts from the article. I don't know much about DDNS at this moment, but I have some notes on Let's Encrypt and running your own domain that I will submit in a later article, at which point I think it makes sense to resurrect this note and link to that/those articles from here.

I think this is good feedback, but I will leave it off for now, because I don't have a clear action in mind that they can take as a result of it, so it distracts from the article. I don't know much about DDNS at this moment, but I have some notes on Let's Encrypt and running your own domain that I will submit in a later article, at which point I think it makes sense to resurrect this note and link to that/those articles from here.
Author
Member

Created a follow-up ticket server/tickets#218

Created a follow-up ticket https://forge.fedoraproject.org/server/tickets/issues/218
brettweir marked this conversation as resolved
@ -0,0 +21,4 @@
[source,console]
----
$ ping fedora.local
Member

ping -c2 fedora.local

this avoids having to exit ping because it will drop out after 2 ping attempts.

ping -c2 fedora.local this avoids having to exit ping because it will drop out after 2 ping attempts.
Author
Member

I incorporated your suggestion (I did 3 because 3s are nice) and clarified the example to actually demonstrate that mDNS specifically is not working (because the machine is responding to ping via IP address).

I incorporated your suggestion (I did 3 because 3s are nice) and clarified the example to actually demonstrate that mDNS specifically is not working (because the machine *is* responding to ping via IP address).
brettweir marked this conversation as resolved
@ -0,0 +53,4 @@
TriggeredBy: ○ avahi-daemon.socket
----
It is disabled, so let's enable it:
Member

Your output shows it as enabled but inactive.
Loaded: loaded (/usr/lib/systemd/system/avahi-daemon.service; enabled; preset: enabled)

Your output shows it as enabled but inactive. Loaded: loaded (/usr/lib/systemd/system/avahi-daemon.service; enabled; preset: enabled)
Author
Member

Updated in the latest commit.

Updated in the latest commit.
brettweir marked this conversation as resolved
@ -0,0 +95,4 @@
[source,console]
----
$ sudo firewall-cmd --permanent --add-service=mdns
success
Member

I'm not sure the success output lines are valuable for these commands. This is present in other examples, but I think it just muddies a set of commands. Personally, I think we should remove outputs like this... but that also requires discussion and agreement on convention. And probably cleanup in other topics. Just noting here so that we can pursue this in channel.

I'm not sure the success output lines are valuable for these commands. This is present in other examples, but I think it just muddies a set of commands. Personally, I think we should remove outputs like this... but that also requires discussion and agreement on convention. And probably cleanup in other topics. Just noting here so that we can pursue this in channel.
Author
Member

Per discussion in Matrix, I will leave these in.

Per discussion in Matrix, I will leave these in.
brettweir marked this conversation as resolved
pboy merged commit caded889fa into main 2026-07-17 08:33:06 +00:00
Sign in to join this conversation.
No description provided.