Skip to content

Document zeroconf_default_interface #12807

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
bdraco merged 5 commits into from
Apr 12, 2020
Merged

Document zeroconf_default_interface #12807

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
619c12d
Document zeroconf_default_interface
bdraco Apr 11, 2020
90a7e5b
homekit -> HomeKit
bdraco Apr 11, 2020
1b5ba29
Update homekit.markdown
bdraco Apr 11, 2020
aef7ca4
Update homekit.markdown
bdraco Apr 11, 2020
c7ffa12
Update homekit.markdown
bdraco Apr 11, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions source/_integrations/homekit.markdown
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -82,6 +82,11 @@ homekit:
required: false
type: boolean
default: false
zeroconf_default_interface:
description: By default, zeroconf will attempt to bind to all interfaces. For systems running using network isolation or similar, this may result HomeKit not being seen on the network. Change this option to `true` if HomeKit cannot be discovered.
required: true
type: boolean
default: false
advertise_ip:
description: If you need to override the IP address used for mDNS advertisement. (For example, using network isolation in Docker and together with an mDNS forwarder like `avahi-daemon` in reflector mode)
required: false
Expand Down Expand Up @@ -332,11 +337,14 @@ To avoid any errors, after you have successfully paired your Home Assistant Brid

The `advertise_ip` option can be used to run this integration even inside an ephemeral Docker container with network isolation enabled, e.g., not using the host network.

You may also need to set `zeroconf_default_interface` to `true`.

To use `advertise_ip`, add the option to your `homekit` configuration:

```yaml
homekit:
advertise_ip: "STATIC_IP_OF_YOUR_DOCKER_HOST"
zeroconf_default_interface: true
```

Restart your Home Assistant instance. This feature requires running an mDNS forwarder on your Docker host, e.g., `avahi-daemon` in reflector mode. This kind of setup most likely requires `safe_mode` during the bridge setup.
Expand Down