Free forever·no account, no tracking, no third-party requests ·open data, free API
showstack / protocols / mqtt

MQTT

Also called MQ Telemetry Transport.

Publish and subscribe messaging designed for unreliable links and small devices. Nothing talks to anything directly: publishers send to a topic on a broker and subscribers ask the broker for topics they care about, which decouples every device from every other. The default plumbing of connected-device work, and increasingly of show integration glue.

Device managementOpenOASISVerified
Management Housekeeping, no deadline

Discovery, monitoring, configuration, backups, updates. Useful, and none of it has a deadline of its own.

What kills it. Nothing kills it. That is the problem: with no deadline it has no manners, and it will happily starve everything that does have one. Putting it on a show VLAN is the commonest self-inflicted wound in the industry.

Why this one, and not what the category suggests. A message broker. In a venue it carries telemetry and status far more often than anything with a deadline.

Ports

tcp/1883 MQTT, unencrypted
tcp/8883 MQTT over TLS

What goes wrong

The broker is a single point of failure and a single point of latency. Run it locally for anything a cue depends on.
Quality-of-service levels 0, 1 and 2 buy delivery guarantees at the cost of round trips. QoS 2 is rarely worth it on a LAN.
Retained messages mean a subscriber can receive a value published hours ago as though it were new. That surprises people exactly once.
Topic naming is a design decision with no standard. Agree the tree before anybody publishes to it.

What speaks MQTT (2)

ProductDirectionNotes
Home Assistant
Open Home Foundation
bidirectional First-class.
Node-RED
OpenJS Foundation
bidirectional First-class, and the reason many people install it.

Typical use

Sources

Something wrong, or missing?

Known gaps on this entry: implementations. If you can source one of them, that is a ten minute pull request.

Edit this entry on GitHub — one file, editable in your browser, and your handle goes on it permanently.

Work at OASIS? Confirm or correct this entry — it is free, it stays free, and nothing about it is for sale.