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

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category

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

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"
}