Getting started with MQTT version 5

MQTT 5.0 in VerneMQ

Starting with VerneMQ 1.6 MQTT 5.0 is included and fully supported by default.

The MQTT 5.0 support in VerneMQ is in BETA until we've had enough feedback and are confident we've gotten the details right. We'll be grateful for any kind of feedback, so please don't hesitate to get in touch with us.

Getting started

First download and install one of the packages of VerneMQ as described here.

When that's done the next step is to enable MQTT 5.0 as it isn't enabled by default. To enable MQTT 5.0 for a listener one has to explicitly allow the protocol version like so:

listener.tcp.allowed_protocol_versions = 3,4,5

The protocol versions allowed by default are 3,4 respectively enabling MQTT version 3.1 and 3.1.1. 5 enables MQTT version 5.0.

More information about configuring MQTT listeners can be found here.

The plugins vmq_acl, vmq_passwd, vmq_diversity and vmq_webhooks have all been updated to support MQTT 5.0. The two first works as one would expect and everything is as usual. The vmq_webhooks plugin exposes all the new MQTT 5.0 specific hooks, see the documentation here.

The vmq_bridge plugin doesn't yet support MQTT 5.0, but this is in the works.

From here you can go to the general documentation and configure the rest as usual.

Reporting issues

To report an issue or a question, please open an issue on github. You're also more than welcome to reach out to us on slack or get in touch with us via our contact form.