From 785bd1d3d84ca772b77f24b72bf08ab155fc56fe Mon Sep 17 00:00:00 2001
From: Mateusz Piotrowski <0mp@FreeBSD.org>
Date: Thu, 18 Apr 2024 10:43:28 +0200
Subject: handbook: network-servers: Add a section about zeroconf and Avahi

Sponsored by:	Klara, Inc.
---
 .../en/books/handbook/network-servers/_index.adoc  | 24 ++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/documentation/content/en/books/handbook/network-servers/_index.adoc b/documentation/content/en/books/handbook/network-servers/_index.adoc
index 07ee163b17..fb4eeaa2b6 100644
--- a/documentation/content/en/books/handbook/network-servers/_index.adoc
+++ b/documentation/content/en/books/handbook/network-servers/_index.adoc
@@ -2007,6 +2007,30 @@ freebsd.org. (A)
 FreeBSD does not provide authoritative name server software in the base system.
 Users are encouraged to install third party applications, like package:dns/nsd[] or package:dns/bind918[] package or port.
 
+[[network-zeroconf]]
+== Zero-configuration networking (mDNS/DNS-SD)
+
+https://en.wikipedia.org/wiki/Zero-configuration_networking[Zero-configuration networking] (sometimes referred to as zeroconf) is a set of technologies, which simplify network configuration by providing:
+
+* automatic assignment of numeric network addresses (mDNS),
+* automatic distribution and resolution of hostnames (mDNS), and
+* automatic discovery of service instances (DNS-SD).
+
+=== Configuring and Starting Avahi
+
+One of the popular implementations of zeroconf is https://avahi.org/[Avahi].
+Avahi can be installed and configured with the following commands:
+
+[source,shell]
+....
+# pkg install avahi-app nss_mdns
+# grep -q '^hosts:.*\<mdns\>' /etc/nsswitch.conf || sed -i "" 's/^hosts: .*/& mdns/' /etc/nsswitch.conf
+# service dbus enable
+# service avahi-daemon enable
+# service dbus start
+# service avahi-daemon start
+....
+
 [[network-apache]]
 == Apache HTTP Server
 
-- 
cgit v1.2.3