LOW
This issue is rated LOW severity due to it being a configuration problem rather than a vulnerability. While frustrating, it does not pose an immediate security risk unless improper configurations lead to broader network exposure or misconfigurations that could be exploited.

The user is experiencing issues with integrating Home Assistant running as a Docker container on TrueNAS, specifically with the Apple HomeKit bridge. The problem stems from networking challenges where the Docker container's network isolation prevents proper communication between the Home Assistant service and the HomeKit bridge on the user's phone. This issue highlights the common challenge of configuring inter-container or container-to-host networking in Docker environments. Specifically, the configuration provided includes settings for `use_x_forwarded_for`, `trusted_proxies`, and `advertise_ip` that should theoretically enable communication but are not resolving the connectivity problem. Engineers and sysadmins must ensure correct network configurations and proxy settings when deploying applications like Home Assistant within Docker containers on systems such as TrueNAS to avoid these types of issues.

Affected Systems
  • TrueNAS with Home Assistant Docker app
  • HomeKit Bridge
Affected Versions: All versions before TrueNAS latest stable release
Remediation
  • Ensure the Docker container is connected to a network bridge that allows communication between containers and external networks by running: `docker network connect homeassistant_container`.
  • Update the Home Assistant configuration file (`configuration.yaml`) with correct networking settings, ensuring `advertise_ip` matches the IP address of the TrueNAS system accessible from your phone: `homekit: - name: HA_bridge port: 21063 ip_address: advertise_ip: `.
  • Verify firewall rules on both TrueNAS and any intermediary devices are not blocking the required ports for Home Assistant and HomeKit communication.
Stack Impact

The issue directly impacts home lab setups utilizing Docker containers within TrueNAS for running Home Assistant, particularly those integrating with Apple's HomeKit ecosystem. Specific configurations in `configuration.yaml` of Home Assistant and network settings on TrueNAS must be correctly adjusted to ensure proper service discovery and communication.

Source →