20220312 homebridge - master branch - PR 1 of 2

Changes image from `oznu/homebridge:no-avahi-arm32v6` to
`oznu/homebridge:latest`:

* `homebridge:latest` pulls `arm` or `arm64` as appropriate
(ie Buster/Bullseye)

* IOTstack defaults to running the container in host mode (as per the
[homebridge documentation](https://github.com/oznu/docker-homebridge/wiki/Homebridge-on-Raspberry-Pi)),
therefore the container can see multicastDNS traffic, therefore
"no-avahi" was never really appropriate. Further, current
[homebridge documentation](https://github.com/oznu/docker-homebridge/wiki)
says:

	> Note: Avahi is now disabled by default in all Alpine builds as
Homebridge no longer requires it. If you have a plugin that requires
avahi, it can enabled by setting the environment variable ENABLE_AVAHI=1.

	`homebridge:latest` pulls an Alpine-based image so the above note
is applicable.

Replaced UI port placeholder with fixed port 8581. This is in line with
the [homebridge documentation](https://github.com/oznu/docker-homebridge/wiki/Homebridge-on-Raspberry-Pi#managing-homebridge).

Removed `build.py` from the homebridge template. The script was
throwing errors, was not substituting the port placeholder with a
sensible default, and was not offering any mechanism to replace the
placeholder with a proper port number.

Added basic documentation.

Signed-off-by: Phill Kelley <[email protected]>

Author: Paraphraser

.templates/homebridge/build.py

@@ -1,16 +1,14 @@
 homebridge:
   container_name: homebridge
-  image: oznu/homebridge:no-avahi-arm32v6
+  image: oznu/homebridge:latest
   restart: unless-stopped
   environment:
     - TZ=Etc/UTC
     - PGID=1000
     - PUID=1000
     - HOMEBRIDGE_CONFIG_UI=1
-    - HOMEBRIDGE_CONFIG_UI_PORT=%WUIPort%
+    - HOMEBRIDGE_CONFIG_UI_PORT=8581
   volumes:
     - ./volumes/homebridge:/homebridge
-  #ports:
-  #  - "4040:4040"
   network_mode: host
 

.templates/homebridge/service.yml

@@ -0,0 +1,45 @@
+# Homebridge
+
+## References 
+
+* [GitHub home](https://github.com/oznu/docker-homebridge)
+* [Configuration Guide](https://github.com/oznu/docker-homebridge/wiki/Homebridge-on-Raspberry-Pi)
+* [DockerHub](https://hub.docker.com/r/oznu/homebridge)
+
+## Configuration
+
+Homebridge documentation has a comprehensive [configuration guide](https://github.com/oznu/docker-homebridge/wiki/Homebridge-on-Raspberry-Pi) which you are encouraged to read.
+
+Homebridge is configured using environment variables. In IOTstack:
+
+* If you are running new menu (master branch, the default), environment variables are kept inline in `docker-compose.yml`.
+* If you are running old menu (old-menu branch), environment variables are at the path:
+
+	```
+	~/IOTstack/services/homebridge/homebridge.env
+	```
+
+In either case, you apply changes by editing the relevant file (`docker-compose.yml` or `homebridge.env`) and then:
+
+```bash
+$ cd ~/IOTstack
+$ docker-compose up -d homebridge
+```
+
+### About "avahi"
+
+"avahi", "multicast DNS", "Rendezvous", "Bonjour" and "ZeroConf" are synonyms.
+
+Current Homebridge images disable avahi services by default. The Homebridge container runs in "host mode" which means it can participate in multicast traffic flows. If you have a plugin that requires avahi, it can enabled by setting the environment variable:
+
+```yaml
+ENABLE_AVAHI=1
+```  
+
+## Web Interface
+
+The web UI for Homebridge can be found on `"your_ip":8581`. You can change the port by adjusting the environment variable:
+
+```
+HOMEBRIDGE_CONFIG_UI_PORT=8581
+```