https://github.com/hardillb/traefik-avahi-helper

A container to create mDNS CNAMEs for Traefik exposed container
https://github.com/hardillb/traefik-avahi-helper

Last synced: 3 months ago
JSON representation

A container to create mDNS CNAMEs for Traefik exposed container

• Host: GitHub
• URL: https://github.com/hardillb/traefik-avahi-helper
• Owner: hardillb
• License: apache-2.0
• Created: 2020-09-30T19:41:56.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2023-09-30T14:25:51.000Z (over 1 year ago)
• Last Synced: 2024-10-13T16:11:33.301Z (3 months ago)
• Language: JavaScript
• Size: 63.5 KB
• Stars: 37
• Watchers: 3
• Forks: 8
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# traefik-avahi-helper

A helper container to expose proxied containers as mDNS CNAMEs that are being proxied by

the offical Traefik docker container.

It reads the same container labels as the Traefik container e.g.

```

traefik.http.routers.r1.rule=Host(`r1.docker.local`)

```

This will create a CNAME entry of `r1.docker.local`

## Installing

`docker pull hardillb/traefik-avahi-helper`

Currently there are AMD64 and ARM64 based builds.

## Running

To work this needs the following 2 volumes mounting:

` -v /var/run/docker.sock:/var/run/docker.sock`

This allows the container to monitor docker

` -v /run/dbus/system_bus_socket:/run/dbus/system_bus_socket`

And this allows the container to send d-bus commands to the host OS's Avahi daemon

```

$ docker run -d -v /var/run/docker.sock:/var/run/docker.sock -v /run/dbus/system_bus_socket:/run/dbus/system_bus_socket hardillb/traefik-avahi-helper 

```

## AppArmor

If you are running on system with AppArmor installed you may get errors about not being able to send d-bus messages. To fix this add

`--privileged` to the command line.

This is a temp workaround until I can work out a suitable policy to apply.

## Acknowledgement

This uses and borrows heavily from [mdns-publisher](https://github.com/alticelabs/mdns-publisher)