home-assistant.io/source/_components/device_tracker.mqtt.markdown

layout	title	description	date	sidebar	comments	sharing	footer	logo	ha_category	ha_iot_class
page	MQTT Device Tracker	Instructions on how to use MQTT to track devices in Home Assistant.	2015-09-19 20:41	true	false	true	true	mqtt.png	Presence Detection	depends

The mqtt device tracker platform allows you to detect presence by monitoring an MQTT topic for new locations. To use this platform, you specify a unique topic for each device.

To use this device tracker in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
device_tracker:
  - platform: mqtt
    devices:
      paulus_oneplus: 'location/paulus'
      annetherese_n4: 'location/annetherese'

Configuration variables:

• devices (Required): List of devices with their topic.
• qos (Optional): The QoS level of the topic.

Example JSON you can publish to the topic (e.g., via mqtt.publish service):

{
  "topic": "/location/paulus",
  "payload": "home"
}