LinuxCommandLibrary

avahi-browse-domains

List available Avahi browsing domains

SYNOPSIS

avahi-browse-domains [options]

PARAMETERS

-h, --help
    Show detailed help page.

-V, --version
    Display version information and exit.

-v, --verbose
    Increase output verbosity for more details.

-d, --debug
    Enable debug messages for troubleshooting.

-k, --cache
    Use only locally cached data; no network queries.

-t, --terminate
    Exit immediately after receiving first packet.

DESCRIPTION

avahi-browse-domains is a command-line utility from the Avahi package, the leading Zeroconf (Zero Configuration Networking) implementation for Linux and Unix-like systems. It enables discovery of browsing domains advertised via Multicast DNS (mDNS) and DNS Service Discovery (DNS-SD) protocols on the local network.

This tool queries the running avahi-daemon to list all available domains where services are being published or browsed. Common domains include .local for link-local services, but it reveals custom or federated domains like .example.com if configured. Domains scope service discovery, allowing organized grouping of services beyond the default LAN scope.

By default, it continuously monitors multicast traffic, printing updates in real-time: = for established domains, + for newly advertised, and - for withdrawn ones. Each line shows the domain name and interface flags (e.g., eth0). This is invaluable for network administrators debugging service discovery, troubleshooting Avahi setups, or mapping Zeroconf topology in environments with IoT devices, printers, or shared services.

Output is color-coded in terminals supporting it, with green for additions, red for removals. The tool depends on avahi-daemon (8) being active and requires no root privileges for basic use. It's lightweight, non-interactive, and integrates well with scripts for automation.

CAVEATS

Requires avahi-daemon(8) to be running; continuous output unless -t specified; may miss transient domains without persistent monitoring.
Local firewall must allow mDNS (UDP 5353).

OUTPUT FORMAT

Lines prefixed with = (established), + (new), - (gone); e.g., = eth0 IPv4 example.local.

EXAMPLES

avahi-browse-domains (continuous monitor)
avahi-browse-domains -t -k (cached snapshot only)

HISTORY

Introduced in Avahi 0.6 (2006) as part of the core client tools. Avahi project started in 2004 by Lennart Poettering to port Apple's Bonjour to Linux; avahi-browse-domains evolved for domain-level introspection in multi-domain setups.

SEE ALSO

avahi-browse(1), avahi-publish-domain(1), avahi-daemon(8), avahi-resolve(1)

Copied to clipboard