{"id":43098600,"url":"https://github.com/phyber/docker-mdns","last_synced_at":"2026-01-31T17:06:03.507Z","repository":{"id":137153581,"uuid":"426325561","full_name":"phyber/docker-mdns","owner":"phyber","description":"Tool for publishing mDNS names via Avahi based on Docker labels","archived":false,"fork":false,"pushed_at":"2025-09-21T20:07:26.000Z","size":271,"stargazers_count":18,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-21T22:08:21.738Z","etag":null,"topics":["avahi","docker","mdns","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/phyber.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-APACHE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-11-09T17:34:48.000Z","updated_at":"2025-09-21T20:07:29.000Z","dependencies_parsed_at":"2023-11-17T20:28:29.924Z","dependency_job_id":"9d5426c8-93cc-40a0-b925-a166728817ea","html_url":"https://github.com/phyber/docker-mdns","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/phyber/docker-mdns","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phyber%2Fdocker-mdns","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phyber%2Fdocker-mdns/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phyber%2Fdocker-mdns/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phyber%2Fdocker-mdns/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/phyber","download_url":"https://codeload.github.com/phyber/docker-mdns/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phyber%2Fdocker-mdns/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28948357,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-31T14:26:55.697Z","status":"ssl_error","status_checked_at":"2026-01-31T14:26:52.545Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["avahi","docker","mdns","rust"],"created_at":"2026-01-31T17:06:02.934Z","updated_at":"2026-01-31T17:06:03.495Z","avatar_url":"https://github.com/phyber.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Docker mDNS\n\nDocker mDNS registers hostnames with Avahi based on labels given to a\ncontainer. This allows each container to have a unique `hostname.local`\nassigned to it, which should help when reverse proxying from tools like\nTraefik or NGINX.\n\n## Minimum Supported Rust Version (MSRV)\n\nThe MSRV for this project is currently v1.82.0\n\n## Configuration\n\nDocker mDNS takes a single command line argument which is the host interface\nthat it should use to find addresses to announce.  For example, if you launch\nit as `docker-mdns eth0` and `eth0` has the IP address `10.20.30.40` this will\nbe the IP address used when when replying to mDNS queries.\n\nDocker mDNS will attempt to find all IP (v4 and v6) addresses on an interface,\nas long as they aren't loopback addresses.\n\nThe rest of the Docker mDNS configuration is done through labels. The supported\nlabels are:\n\n| Label                   | Default | Description                     |\n|-------------------------|---------|---------------------------------|\n| `docker-mdns.enable`    | `false` | Enable mDNS for the container   |\n| `docker-mdns.host`      | `None`  | Hostname(s) to announce         |\n| `docker-mdns.interface` | `None`  | Interface to get addresses from |\n\nThe `docker-mdns.host` label can take a list of whitespace separated hostnames\nif you want multiple hostnames for a container.\n\nProviding `docker-mdns.interface` will override which interface Docker mDNS\nuses when finding IP addresses to announce for the `docker-mdns.host`.\n\nThe following is an example of a `docker-compose.yaml` file to run Docker mDNS\nin a container:\n\n```yaml\n---\nservices:\n  mdns:\n    container_name: \"docker-mdns\"\n    image: \"ghcr.io/phyber/docker-mdns:aarch64-latest\"\n\n    # We need to be able to see the real IP addresses on the host, so we need\n    # host networking mode.\n    network_mode: \"host\"\n\n    # Set this to the name of the interface with the IP addresses you'd like to\n    # announce for your hostnames.\n    # Both IPv4 and IPv6 addresses will be used.\n    command:\n      - \"eth0\"\n\n    # We need to be able to read docker.sock to watch for container events,\n    # and we need to be able to write to the system d-bus socket to add\n    # hostnames in Avahi\n    volumes:\n      - \"/var/run/dbus/system_bus_socket:/var/run/dbus/system_bus_socket:rw\"\n      - \"/var/run/docker.sock:/var/run/docker.sock:ro\"\n```\n\nAnd the following would configure Traefik to present its dashboard on a\nconfigured mDNS hostname:\n\n```yaml\n---\nservices:\n  traefik:\n    container_name: \"traefik\"\n    image: \"traefik:v2.8.1\"\n    restart: \"unless-stopped\"\n    command:\n      - \"--entrypoints.web.address=:80\"\n      - \"--providers.docker=true\"\n      - \"--providers.docker.exposebydefault=false\"\n    labels:\n      docker-mdns.enable: \"true\"\n      docker-mdns.host: \"traefik.local\"\n      traefik.enable: \"true\"\n      traefik.http.routers.traefik.endpoints: \"web\"\n      traefik.http.routers.traefik.rule: \"Host(`traefik.local`)\"\n      traefik.http.services.traefik.loadbalancer.server.port: \"8080\"\n    ports:\n      - \"80:80\"\n      - \"8080:8080\"\n    volumes:\n      - \"/var/run/docker.sock:/var/run/docker.sock:ro\"\n```\n\n## License\n\nLicensed under either of\n\n  * Apache License, Version 2.0\n    ([LICENSE-APACHE] or https://www.apache.org/licenses/LICENSE-2.0)\n  * MIT license\n    ([LICENSE-MIT] or https://opensource.org/licenses/MIT)\n\nat your option.\n\n\u003c!-- links --\u003e\n[LICENSE-APACHE]: LICENSE-APACHE\n[LICENSE-MIT]: LICENSE-MIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphyber%2Fdocker-mdns","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphyber%2Fdocker-mdns","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphyber%2Fdocker-mdns/lists"}