KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #cli #claude-code #codex #developer-tools #dsh-plugin #ai-agent #mcp #deepseek-harness #windows #open-source

avahi

★ 89 Open GitHub ↗

Docker image for the Avahi mDNS/DNS-SD daemon.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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.

```shell
docker run flungo/avahi
```

## 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:

| Section     | Option                            | Variable                                  |
| ----------- | --------------------------------- | ----------------------------------------- |
| `server`    | `host-name`                       | `SERVER_HOST_NAME`                        |
| `server`    | `domain-name`                     | `SERVER_DOMAIN_NAME`                      |
| `server`    | `browse-domains`                  | `SERVER_BROWSE_DOMAINS`                   |
| `server`    | `use-ipv4`                        | `SERVER_USE_IPV4`                         |
| `server`    | `use-ipv6`                        | `SERVER_USE_IPV6`                         |
| `server`    | `allow-interfaces`                | `SERVER_ALLOW_INTERFACES`                 |
| `server`    | `deny-interfaces`                 | `SERVER_DENY_INTERFACES`                  |
| `server`    | `check-response-ttl`              | `SERVER_CHECK_RESPONSE_TTL`               |
| `server`    | `use-iff-running`                 | `SERVER_USE_IFF_RUNNING`                  |
| `server`    | `enable-dbus`                     | `SERVER_ENABLE_DBUS`                      |
| `server`    | `disallow-other-stacks`           | `SERVER_DISALLOW_OTHER_STACKS`            |
| `server`    | `allow-point-to-point`            | `SERVER_ALLOW_POINT_TO_POINT`             |
| `server`    | `cache-entries-max`               | `SERVER_CACHE_ENTRIES_MAX`                |
| `server`    | `clients-max`                     | `SERVER_CLIENTS_MAX`                      |
| `server`    | `objects-per-client-max`          | `SERVER_OBJECTS_PER_CLIENT_MAX`           |
| `server`    | `entries-per-entry-group-max`     | `SERVER_ENTRIES_PER_ENTRY_GROUP_MAX`      |
| `server`    | `ratelimit-interval-usec`         | `SERVER_RATELIMIT_INTERVAL_USEC`          |
| `server`    | `ratelimit-burst`                 | `SERVER_RATELIMIT_BURST`                  |
| `wide-area` | `enable-wide-area`                | `WIDE_AREA_ENABLE_WIDE_AREA`              |
| `publish`   | `disable-publishing`              | `PUBLISH_DISABLE_PUBLISHING`              |
| `publish`   | `disable-user-service-publishing` | `PUBLISH_DISABLE_USER_SERVICE_PUBLISHING` |
| `publish`   | `add-service-cookie`              | `PUBLISH_ADD_SERVICE_COOKIE`              |
| `publish`   | `publish-addresses`               | `PUBLISH_PUBLISH_ADDRESSES`               |
| `publish`   | `publish-hinfo`                   | `PUBLISH_PUBLISH_HINFO`                   |
| `publish`   | `publish-workstation`             | `PUBLISH_PUBLISH_WORKSTATION`             |
| `publish`   | `publish-domain`                  | `PUBLISH_PUBLISH_DOMAIN`                  |
| `publish`   | `publish-dns-servers`             | `PUBLISH_PUBLISH_DNS_SERVERS`             |
| `publish`   | `publish-resolv-conf-dns-servers` | `PUBLISH_PUBLISH_RESOLV_CONF_DNS_SERVERS` |
| `publish`   | `publish-aaaa-on-ipv4`            | `PUBLISH_PUBLISH_AAAA_ON_IPV4`            |
| `publish`   | `publish-a-on-ipv6`               | `PUBLISH_PUBLISH_A_ON_IPV6`               |
| `reflector` | `enable-reflector`                | `REFLECTOR_ENABLE_REFLECTOR`              |
| `reflector` | `reflect-ipv`                     | `REFLECTOR_REFLECT_IPV`                   |
| `reflector` | `reflect-filters`                 | `REFLECTOR_REFLECT_FILTERS`               |
| `rlimits`   | `rlimit-as`                       | `RLIMITS_RLIMIT_AS`                       |
| `rlimits`   | `rlimit-core`                     | `RLIMITS_RLIMIT_CORE`                     |
| `rlimits`   | `rlimit-data`                     | `RLIMITS_RLIMIT_DATA`                     |
| `rlimits`   | `rlimit-fsize`                    | `RLIMITS_RLIMIT_FSIZE`                    |
| `rlimits`   | `rlimit-nofile`                   | `RLIMITS_RLIMIT_NOFILE`                   |
| `rlimits`   | `rlimit-stack`                    | `RLIMITS_RLIMIT_STACK`                    |
| `rlimits`   | `rlimit-nproc`                    | `RLIMITS_RLIMIT_NPROC`                    |

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

## Examples

This sections contains several example usages for the. If you use this container for a common scenrio or if any of the examples can be improved, please let me know the configurtion you have used so that I can add it here or submit a PR adding it as an example.

### Reflect mDNS broadcasts between networks

To reflect mDNS broadcasts between two docker networks (`net1` and `net2` in the example given) the reflector should be enabled by setting `REFLECTOR_ENABLE_REFLECTOR=yes`.

```shell
# Create a container named mdns-reflector attached to net1
docker run -d --name=mdns-reflector \
  --network net1 \
  -e REFLECTOR_ENABLE_REFLECTOR=yes \
  flungo/avahi
# Attach the container to the net2 network
docker network connect net2 mdns-reflector
```

See [Connecting to a phyiscal network](#connecting_to_a_physical_network) to see how you can connect the container to a physical network - for example if you wanted to reflect mDNS between two WiFi VLANs).

### Connecting to a physical network

It is common to want to use this container with one or more physical networks (e.g. as a reflector between WiFi network), in order to do this a docker network can be created using the [macvlan](https://docs.docker.com/network/macvlan/) driver. The following example creates a macvlan network named `physical` connected to the `eno1` interface with subnet `10.0.0.0/24` and gateway `10.0.0.1`.

```bash
docker network create --driver macvlan --subnet 10.0.0.0/24 --gateway 10.0.0.1 --opt parent=eno1 physical
```

You can also connect to a VLAN on a physical interface by suffixing the parent with `.` and the VLAN ID (e.g. `--opt parent=eno1.123` for VLAN 123 on the `eno1` interface. The sub-interface does not need to exist before running the command to create the network as the driver will automatically create this.

To ensure that an IP conflict does not occur, you should specify an available IP address on your physical network when attaching the network to your container. Assuming that your container is called `avahi` and `10.0.0.10` is an available IP in that network, you can connect this network as follows:

```bash
docker network connect physical avahi --ip 10.0.0.10
```

avahi

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README