MQTT is a lightweight binary pubsub protocol suited to embedded devices. This module provides a way for MQTT clients to connect to Prosody and publish or subscribe to local pubsub nodes.


MQTT has the concept of ‘topics’ (similar to XMPP’s pubsub ‘nodes’). mod_pubsub_mqtt maps pubsub nodes to MQTT topics of the form HOST/NODE,


The current implementation is quite basic, and in particular:


XMPP payloads are always XML, but MQTT does not define a payload format. Therefore mod_pubsub_mqtt will attempt to convert data of certain recognised payload types. Currently supported:

All other XMPP payload types are sent to the client directly as XML. Data published by MQTT clients is currently never translated, and always treated as UTF-8 text.


There is no special configuration for this module. Simply load it on your pubsub host like so:

Component "" "pubsub"
    modules_enabled = { "pubsub_mqtt" }

You may also configure which port(s) mod_pubsub_mqtt listens on using Prosody’s standard config directives, such as mqtt_ports. Network settings must be specified in the global section of the config file, not under any particular pubsub component. The default port is 1883 (MQTT’s standard port number).


trunk Works
0.9 Works
0.8 Doesn’t work


With the plugin installer in Prosody 0.12 you can use:

sudo prosodyctl install --server= mod_pubsub_mqtt

For earlier versions see the documentation for installing 3rd party modules