2.1 KiB
layout, title, description, date, sidebar, comments, sharing, footer, ha_category, ha_release
| layout | title | description | date | sidebar | comments | sharing | footer | ha_category | ha_release | |
|---|---|---|---|---|---|---|---|---|---|---|
| page | Zeroconf/Avahi/Bonjour | Exposes Home Assistant using the Zeroconf protocol. | 2016-04-10 18:50 | true | false | true | true |
|
0.18 |
The zeroconf integration will scan the network for supported devices and services. Discovered integrations will show up in the discovered section on the integrations page in the config panel. It will also make Home Assistant discoverable for other services in the network. Zeroconf is also sometimes known as Bonjour, Rendezvous, and Avahi.
Integrations can opt-in to be found by adding either a Zeroconf section or a HomeKit section to their manifest.json.
{% linkable_title Configuration %}
To integrate this into Home Assistant, add the following section to your configuration.yaml file:
# Example configuration.yaml entry
zeroconf:
The registration will include meta-data about the Home Assistant instance, including a base URL that can be used to access Home Assistant and the currently running Home Assistant version. The examples below show two ways to retrieve the details for testing.
$ avahi-browse -alr
+ eth0 IPv4 Home _home-assistant._tcp local
= eth0 IPv4 Home _home-assistant._tcp local
hostname = [Home._home-assistant._tcp.local]
address = [192.168.0.70]
port = [8123]
txt = ["base_url=http://192.168.0.70:8123" "requires_api_password=true" "version=0.41.0"]
$ avahi-discover
Browsing domain 'local' on -1.-1 ...
Browsing for services of type '_home-assistant._tcp' in domain 'local' on 4.0 ...
Found service 'Home' of type '_home-assistant._tcp' in domain 'local' on 4.0.
Service data for service 'Home' of type '_home-assistant._tcp' in domain 'local' on 4.0:
Host Home._home-assistant._tcp.local (192.168.0.70), port 8123, TXT data:
['requires_api_password=true', 'base_url=http://192.168.0.70:8123', 'version=0.41.0']