epandi/avahi repository overview

⁠arm32v7 fork of flungo/avahi

⁠Avahi Docker Image

Docker image for the Avahi mDNS/DNS-SD daemon. Built on Alpine Linux to make the image as small as possible. Highly configurable through environment variables to support most usecases which need an Avahi Daemon.

⁠Usage

Basic usage consists of running the docker container with the appropriate environment variables and volumes to achieve your desired behaviour.

⁠Environment variables

Environment variables are made available for all of the options of avahi-daemon.conf. The variable names are in the format <SECTION>_<OPTION> where <SECTION> is the capitalised section name from the configuration file and <OPTION> is the capitalised option name with - replaced by _. The table below outlines the available options:

If you find an option you require is missing, report this or make a PR adding that feature.

⁠Example using Avahi in combination with Home Assistant (for cast mdns support)

docker-compose yaml

physical network where the cast devices are located: 10.0.x.x, subnet 255.255.252.0, gateway 10.0.0.1, avahi docker ip set to 10.0.0.199

internal mdns docker network name "avahi_mdns"

version: '2.2'
services:
  mdns-reflector:
    image: epandi/avahi
    environment:
      - REFLECTOR_ENABLE_REFLECTOR=yes
    restart: always
    networks:
      outside:
        ipv4_address: 10.0.0.199
      inside:

networks:
  inside:
    name: avahi_mdns
    driver: bridge
    ipam:
      config:
        - subnet: 172.20.2.0/24
          gateway: 172.20.2.1
  outside:
    name: physical
    driver: macvlan
    driver_opts:
      parent: eth0
    ipam:
      config:
        - subnet: 10.0.0.0/22
          gateway: 10.0.0.1

Home Assistant docker-compose.yaml

(use network_mode: avahi_mdns)

version: "2.2"
services:
  home-assistant:
    image: homeassistant/home-assistant:latest
    environment:
      - TZ=Europe/Amsterdam
    volumes:
      - /etc/localtime:/etc/localtime:ro 
      - /etc/timezone:/etc/timezone:ro 
      - /home/pi/Docker/home-assistant/data/config:/config
    ports:
      - "8123:8123"
    network_mode: avahi_mdns
    restart: unless-stopped