mDNS Reflector

Docker container of mDNS Reflector, a lightweight and performant multicast DNS reflector.

It reflects mDNS queries and responses between multiple network interfaces, allowing devices in separate LANs to discover each other without placing them in the same broadcast domain.

This is useful when running IoT devices in a separate network while still allowing discovery from your main LAN.

Features ✨

• Reflects mDNS traffic between multiple interfaces
• Supports both IPv4 and IPv6
• Lightweight Alpine-based image

Usage 🐳

Docker Compose:

services:
  mdns:
    image: dockurr/mdns
    container_name: mdns
    network_mode: host
    environment:
      INTERFACES: "eth0 vlan20"
    restart: always

Docker CLI:

docker run -it --rm --name mdns -e "INTERFACES=eth0 vlan20" --network host docker.io/dockurr/mdns

Important

This container requires host networking because the reflector needs access to the real network interfaces and multicast traffic.

Configuration ⚙️

How do I select the interfaces?

Set the INTERFACES environment variable to a space-separated list of interfaces that should participate in mDNS reflection.

environment:
  INTERFACES: "eth0 vlan20"

At least two interfaces are required.

How do I find my interface names?

On the host, run:

ip link

Common examples are eth0, br0, vlan20, eno1, or bridge/VLAN interfaces created by your router, firewall, or virtualization platform.

Stars 🌟