darendarrow/docker-mdns-repeater repository overview

⁠mdns-repeater Docker image

⁠About

mdns-repeater in the Docker container.

⁠mdns-repeater

mdns-repeater is a Multicast DNS⁠ (mDNS) repeater for Linux.

This program is an application level gateway which re-broadcasts mDNS packets received on one interface to other interfaces. Since mDNS is "administratively scoped" such a gateway is required when mDNS resolutions should work across subnet borders.

⁠Upstream Links

• Docker Registry @monstrenyatko/mdns-repeater⁠
• GitHub @monstrenyatko/docker-mdns-repeater⁠

⁠Usage

mdns-repeater only requires the interface names and it will do the rest.

Example:

mdns-repeater eth0 vlan1

You can also specify the:

• -f flag to keep mdns-repeater running in foreground.
• -d flag additionally to -f to print out parsed mDNS packets as they are received

⁠Docker image Usage

Container is already configured for automatic restart (See docker-compose.yml).

• Configure environment:

  • MDNS_REPEATER_INTERFACES: names of the interfaces:

      export MDNS_REPEATER_INTERFACES="eth0 docker0"
    

    Copy

  • DOCKER_REGISTRY: [OPTIONAL] registry prefix to pull image from a custom Docker registry:

      export DOCKER_REGISTRY="my_registry_hostname:5000/"
    

    Copy

• Pull prebuilt Docker image:

    docker-compose pull
  

  Copy

• Start prebuilt image:

    docker-compose up -d
  

  Copy

• Stop/Restart:

    docker-compose stop
    docker-compose start
  

  Copy

⁠Acknowledgments

• Darell Tan who created the initial version of this program⁠ and who described it in this blog post⁠.
• Kenny Levinsen and contributors for maintaining the code and adding features in this repository⁠.
• Matthias Dettling for -d flag idea in this repository⁠.