Skip to content

monstrenyatko/docker-mdns-repeater

 
 

Repository files navigation

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

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"
    • DOCKER_REGISTRY: [OPTIONAL] registry prefix to pull image from a custom Docker registry:

        export DOCKER_REGISTRY="my_registry_hostname:5000/"
  • Pull prebuilt Docker image:

      docker-compose pull
  • Start prebuilt image:

      docker-compose up -d
  • Stop/Restart:

      docker-compose stop
      docker-compose start

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.

About

Recipe to build the mdns-repeater Docker image

Topics

Resources

License

Stars

Watchers

Forks

Languages

  • C 91.7%
  • Dockerfile 4.5%
  • Shell 3.8%