jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-05-02 01:07:36 +00:00
Code Issues Packages Projects Releases Wiki Activity
home-assistant.io/source/_components/zeroconf.markdown
Jorim Tielemans c0d8b1fbf0 Clean up wxz (#7025) 
Titles
Trailing spaces
Boolean capitalization
2018-10-23 11:08:53 +02:00

1.8 KiB
Raw Blame History

layout title description date sidebar comments sharing footer logo ha_category ha_release
page Zeroconf/Avahi/Bonjour Exposes Home Assistant using the Zeroconf protocol. 2016-04-10 18:50 true false true true avahi.png Network 0.18

The zeroconf component exposes your Home Assistant to the local network using Zeroconf. Zeroconf is also sometimes known as Bonjour, Rendezvous, and Avahi.

{% 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, the currently running Home Assistant version, and whether an API password is needed to access the instance. 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']