avahi-publish-service

Register mDNS/DNS-SD services on the local network

TLDR

Publish mDNS service

$ avahi-publish-service [MyService] [_http._tcp] [80]

Publish with service text

$ avahi-publish-service [MyService] [_http._tcp] [80] ["path=/api"]

Publish on a specific host

$ avahi-publish-service -H [myhost.local] [MyService] [_http._tcp] [80]

Publish with subtype

$ avahi-publish-service --subtype=[_printer._sub._http._tcp] [MyPrinter] [_http._tcp] [631]

SYNOPSIS

avahi-publish-service [options] name service-type port [txt-record...]

avahi-publish-service registers a mDNS/DNS-SD service on the local network via the Avahi daemon. It allows services to be discovered by other devices using Avahi or Bonjour-compatible service discovery. This command is equivalent to avahi-publish -s and provides a convenient shortcut specifically for service registration.The tool requires a service name, a DNS-SD service type (e.g., _http._tcp), and a port number. Optional TXT record strings can provide additional metadata about the service. Service subtypes can be registered for more specific categorization.The registration persists only while the process is running. When terminated, the service advertisement is automatically withdrawn from the network.

PARAMETERS

-H, --host=HOSTNAME

Specify a host name for the service if it does not reside on the local host. Must be fully qualified and resolvable via mDNS or unicast DNS.

-d, --domain=DOMAIN

Publish in the specified domain. If omitted, the Avahi daemon publishes in its default domain (usually .local).

--subtype=SUBTYPE

Register the service with an additional subtype. May be passed multiple times.

-f, --no-fail

Don't fail if the daemon is not running. Wait for it to appear and reconnect if it disconnects.

-v, --verbose

Enable verbose mode.

-V, --version

Show version information.

-h, --help

Show help.

CAVEATS

Requires avahi-daemon running. Service persists only while command is running. Firewall must allow mDNS (UDP port 5353). Service names must be unique on the network.

HISTORY

avahi-publish-service is part of the Avahi project, created by Lennart Poettering as a free implementation of Apple's Bonjour/Zeroconf protocol, first released around 2005.