From 88e918f90a51a2e0d7d66d12b1fbc9e4db6001db Mon Sep 17 00:00:00 2001 From: NanoSector Date: Wed, 19 Jan 2022 19:08:47 +0100 Subject: [PATCH] Add section about configuring macvtap multicast to HomeKit (#21181) Co-authored-by: J. Nick Koston Co-authored-by: Franck Nijhof --- source/_integrations/homekit.markdown | 4 ++++ source/_integrations/zeroconf.markdown | 25 +++++++++++++++++++++++++ 2 files changed, 29 insertions(+) diff --git a/source/_integrations/homekit.markdown b/source/_integrations/homekit.markdown index dcc23e6e555..272c85d51d1 100644 --- a/source/_integrations/homekit.markdown +++ b/source/_integrations/homekit.markdown @@ -543,6 +543,10 @@ You can also try to use `avahi-daemon` in reflector mode together with the optio Configure the network mode as `networkbridge`. Otherwise the Home Assistant Bridge won't be exposed to the network. +#### Accessory does not appear in the Home App (for pairing) - Libvirt QEMU/KVM virtual machine with macvtap adapter + +Please see the [Zero-configuration networking](/integrations/zeroconf/#troubleshooting) integration for more details. + #### Pairing hangs - zeroconf error Pairing eventually fails, you might see the error message, `NonUniqueNameException`, you likely need to enable `default_interface: true` in the `zeroconf` integration configuration and set a unique name such as `name: MyHASS42`. diff --git a/source/_integrations/zeroconf.markdown b/source/_integrations/zeroconf.markdown index 0b83a9c0181..cf744403f49 100644 --- a/source/_integrations/zeroconf.markdown +++ b/source/_integrations/zeroconf.markdown @@ -29,3 +29,28 @@ zeroconf: Zeroconf chooses which interfaces to broadcast on based on the [Network](/integrations/network/) integration. IPv6 will automatically be enabled if one of the selected interfaces has an IPv6 address that is enabled via the Network integration. + +## Troubleshooting + +### Integrations relying on Zeroconf traffic are unresponsive + +Some integrations rely on Zeroconf traffic to work, for example, the [HomeKit](/integrations/homekit/) integration. +These integrations will not respond to traffic from other devices if the host device is not configured correctly. + +#### Libvirt virtual machine with macvtap adapter + +By default, the macvtap adapter created by libvirt does not allow the guest to receive Zeroconf or multicast traffic. + +Configure the virtual machine to accept this traffic by adding the `trustGuestRxFilters="yes"` setting in the adapter's XML. For example: + +```xml + + + + + +
+ +``` + +This only works with the `virtio` network adapter type and it is disabled by default for security reasons. See [the libvirt documentation](https://libvirt.org/formatdomain.html#elementsNICS) for more details. \ No newline at end of file