Skip to main content
Version: Mosquitto 2.7

Release Notes

We will never stop improving Eclipse Mosquitto. Stay up to date with our release notes.

If you have found any bugs or have feature requests, please submit these here.

Mosquitto MQTT Broker & MMC 2.7

Features

  • Kafka Bridge: The MQTT to Kafka bridge facilitates a unidirectional data transfer mechanism, enabling seamless MQTT data transmission from Pro Mosquitto to Kafka. The feature allows users to conveniently configure the MQTT to Kafka topics mapping, with Pro Mosquitto ensuring the automatic data transfer from the chosen MQTT topics to the specified Kafka destinations. The MQTT to Kafka bridge allows to:

    • Specify the Kafka server
    • Choose the authentication method
    • Select which topics to publish
    • Map MQTT topics to Kafka topics
  • MongoDB Bridge: The MongoDB Bridge enables one-way data transfer from MQTT to MongoDB. It's built for effortless data migration, allowing users to handle MQTT-generated data in MongoDB efficiently. The MQTT to MongoDB bridge allows to:

    • Specify the database and collection to import to
    • Choose the authentication method
    • Select which topics and message fields to import
    • Map topics to specific collections
    • Choose which fields to insert into collections
  • Kubernetes Support: Kubernetes] container deployment support enables users to install and run Pro Mosquitto within Kubernetes.

  • Audit Trails: The Audit Trails feature provides a detailed record of every significant action, creating an append-only log, bot for Mosquitto and MMC.

  • Prometheus Exporter: Pro Mosquitto now implements a Prometheus exporter, allowing Prometheus to query Pro Mosquitto for metrics to be monitored directly. The metrics set gives a broad overview of what is happening on your broker, from the number of clients connected to the count of individual MQTT message types sent and received.

  • Sparkplug Awareness: Mosquitto 2.7 (Pro & OS) implements the full functionality of a Sparkplug Aware Broker, aligning seamlessly with the requirements outlined in the official Sparkplug specification.

  • Configurable Leader Election: The Configurable Leader Election gives users complete control over the leader selection process within an HA cluster. Users can now define which specific node in the cluster should act as the leader. This setting ensures that the most suitable node seamlessly takes over the leader role. It is an addition to the current HA MQTT API.

Changes

  • Cluster Management UI: In the connections tab, icons are now used to distinguish leaders and followers within an HA cluster.

  • Small Bug Fixes for the MMC and Mosquitto.

How to Upgrade

To upgrade adjust your docker-compose file and the config files as described here. Download the new images via a docker-compose pull and start up again.

Mosquitto MQTT Broker & MMC 2.6

Features

  • Client certificate authority management: The MMC is now able to store client certificate authorities and deploy them on all connected broker supporting the respective MQTT API endpoints. This allows the MMC to be the central unit around uploading and organizing client certificate authorities. This is the first step forward on supporting UI support for client certificate management. This feature will be further expanded in a future release.

  • Client Inspect: We have extended the client inspect plugin information. Now it is possible to check queue sizes (only important for QoS 1 & 2) and directly disconnect a client via the UI.

  • HA Cluster: Added new mode. The new Dynamic Security Synchronisation Cluster Mode provides a different type of HA cluster that synchronises the Dynamic Security authentication and authorisation settings throughout the cluster. Each node in the cluster is active and available for clients to connect to, but there is no inter-node MQTT communication.

Changes

  • General UI changes: The whole MMC has gotten a face-lift. All pages have been reworked to fit in the new UI.

  • Sidebar: The sidebar was rearranged to visually separate broker specific and global options. Broker specific pages can be found on the top and other are can be found at the bottom of the navigation bar.

  • Status Page: Is now called "Home" and went through a face-lift. A chart was added showing the currently connected clients and the maximum allowed client connections.

  • Breaking: Changed the "themes" structure in the config.json of the Management Center.

  • Bug Fixes

  • Added a new way of loading MMC plugins. The file "plugins.json" can now be used to manually configure the plugins. The config.json loads the content of the file on start if the environment variable "CEDALO_MC_PLUGIN_LIST_PATH: management-center/config/plugins.json" is set. If no file is found an error message is shown and the config.json file will be read. If the file is found, the config.json file plugin list will be overwritten on start. The plugin.json file is only readable not writable by the MMC.

How to Upgrade

To upgrade adjust your docker-compose file and the config files as described here. Download the new images via a docker-compose pull and start up again.

Mosquitto MQTT Broker 2.0

Broker features:

  • New plugin interface which is more flexible, easier to develop for and easier to extend.

  • New dynamic security plugin, which allows clients, groups, and roles to be defined and updated as the broker is running.

  • Performance improvements, particularly for higher numbers of clients.

  • When running as root, if dropping privileges to the "mosquitto" user fails, then try "nobody" instead. This reduces the burden on users installing Mosquitto themselves.

  • Add support for Unix domain socket listeners.

  • Add bridge_outgoing_retain option, to allow outgoing messages from a bridge to have the retain bit completely disabled, which is useful when bridging to e.g. Amazon or Google.

  • Add support for MQTT v5 bridges to handle the "retain-available" property being false.

  • Allow MQTT v5.0 outgoing bridges to fall back to MQTT v3.1.1 if connecting to a v3.x only broker.

  • DLT logging is now configurable at runtime with log_dest dlt. Closes #1735.

  • Add mosquitto_plugin_publish() function, which can be used by plugins to publish messages.

  • Add mosquitto_client_protocol_version() function which can be used by plugins to determine which version of MQTT a client has connected with.

  • Add mosquitto_kick_client_by_clientid() and mosquitto_kick_client_by_username() functions, which can be used by plugins to disconnect clients.

  • Add support for handling $CONTROL/ topics in plugins.

  • Add support for PBKDF2-SHA512 password hashing.

  • Enabling certificate based TLS encryption is now through certfile and keyfile, not capath or cafile.

  • Added support for controlling UNSUBSCRIBE calls in v5 plugin ACL checks.

  • Add "deny" acl type. Closes #1611.

  • The broker now sends the receive-maximum property for MQTT v5 CONNACKs.

  • Add the bridge_max_packet_size option. Closes #265.

  • Add the bridge_bind_address option. Closes #1311.

  • TLS certificates for the server are now reloaded on SIGHUP.

  • Default for max_queued_messages has been changed to 1000.

  • Add ciphers_tls1.3 option, to allow setting TLS v1.3 ciphersuites. Closes #1825.

  • Bridges now obey MQTT v5 server-keepalive.

  • Add bridge support for the MQTT v5 maximum-qos property.

  • Log client port on new connections. Closes #1911.

Broker fixes:

  • Send DISCONNECT with malformed-packet reason code on invalid PUBLISH, SUBSCRIBE, and UNSUBSCRIBE packets.

  • Document that X509_free() must be called after using mosquitto_client_certificate(). Closes #1842.

  • Fix listener not being reassociated with client when reloading a persistence file and per_listener_settings true is set and the client did not set a username. Closes #1891.

  • Fix bridge sock not being removed from sock hash on error. Closes #1897. mosquitto_password now forbids the : character. Closes #1833.

  • Fix log_timestamp_format not applying to log_dest topic. Closes #1862.

  • Fix crash on Windows if loading a plugin fails. Closes #1866.

  • Fix file logging on Windows. Closes #1880.

  • Report an error if the config file is set to a directory. Closes #1814.

  • Fix bridges incorrectly setting Wills to manage remote notifications when notifications_local_only was set true. Closes #1902.