Version 2.0.8 released.

Version 2.0.8 of Mosquitto has been released. This is a bugfix release.

Broker

  • Fix incorrect datatypes in struct mosquitto_evt_tick. This changes the size and offset of two of the members of this struct, and changes the size of the struct. This is an ABI break, but is considered to be acceptable because plugins should never be allocating their own instance of this struct, and currently none of the struct members are used for anything, so a plugin should not be accessing them. It would also be safe to read/write from the existing struct parameters.
  • Give compile time warning if libwebsockets compiled without external poll support. Closes #2060.
  • Fix memory tracking not being available on FreeBSD or macOS. Closes #2096.

Client library

  • Fix mosquitto_{pub|sub}_topic_check() functions not returning MOSQ_ERR_INVAL on topic == NULL.

Clients

  • Fix possible loss of data in mosquitto_pub -l when sending multiple long lines. Closes #2078.

Build

  • Provide a mechanism for Docker users to run a broker that doesn't use authentication, without having to provide their own configuration file. Closes #2040.

Version 2.0.7 released.

Version 2.0.7 and 1.6.13 of Mosquitto have been released. These are bugfix releases.

2.0.7

Broker

  • Fix exporting of executable symbols on BSD when building via makefile.
  • Fix some minor memory leaks on exit only.
  • Fix possible memory leak on connect. Closes #2057.
  • Fix openssl engine not being able to load private key. Closes #2066.

Clients

  • Fix config files truncating options after the first space. Closes #2059.

Build

  • Fix man page building to not absolutely require xsltproc when using CMake. This now handles the case where we are building from the released tar, or building from git if xsltproc is available, or building from git if xsltproc is not available.

1.6.13

Broker:

  • Fix crash on Windows if loading a plugin fails. Closes #1866.
  • Fix DH group not being set for TLS connections, which meant ciphers using DHE couldn't be used. Closes #1925. Closes #1476.
  • Fix local bridges being disconnected on SIGHUP. Closes #1942.
  • Fix $SYS/broker/publish/messages/+ counters not being updated for QoS 1, 2 messages. Closes #1968.
  • 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 file logging on Windows. Closes #1880.
  • Fix bridge sock not being removed from sock hash on error. Closes #1897.

Client library:

  • Fix build on Mac Big Sur. Closes #1905.
  • Fix DH group not being set for TLS connections, which meant ciphers using DHE couldn't be used. Closes #1925. Closes #1476.

Clients:

  • mosquitto_sub will now quit with an error if the %U option is used on Windows, rather than just quitting. Closes #1908.
  • Fix config files truncating options after the first space. Closes #2059.

Apps:

  • Perform stricter parsing of input username in mosquitto_passwd. Closes #570126 (Eclipse bugzilla).

Build:

  • Enable epoll support in CMake builds.

Version 2.0.6 released.

Version 2.0.6 of Mosquitto has been released. This is a bugfix release.

Broker

  • Fix calculation of remaining length parameter for websockets clients that send fragmented packets. Closes #1974.
  • Fix potential duplicate Will messages being sent when a will delay interval has been set.
  • Fix message expiry interval property not being honoured in mosquitto_broker_publish and mosquitto_broker_publish_copy.
  • Fix websockets listeners with TLS not responding. Closes #2020.
  • Add notes that libsystemd-dev or similar is needed if building with systemd support. Closes #2019.
  • Improve logging in obscure cases when a client disconnects. Closes #2017.
  • Fix reloading of listeners where multiple listeners have been defined with the same port but different bind addresses. Closes #2029.
  • Fix message_size_limit not applying to the Will payload. Closes #2022.
  • The error topic-alias-invalid was being sent if an MQTT v5 client published a message with empty topic and topic alias set, but the topic alias hadn't already been configured on the broker. This has been fixed to send a protocol error, as per section 3.3.4 of the specification.
  • Note in the man pages that SIGHUP reloads TLS certificates. Closes #2037.
  • Fix bridges not always connecting on Windows. Closes #2043.

Apps

  • Allow command line arguments to override config file options in mosquitto_ctrl. Closes #2010.
  • mosquitto_ctrl: produce an error when requesting a new password if both attempts do not match. Closes #2011.

Build

  • Fix cmake builds using WITH_CJSON=no not working if cJSON not found. Closes #2026.

Other

  • The SPDX identifiers for EDL-1.0 have been changed to BSD-3-Clause as per The Eclipse legal documentation generator. The licenses are identical.

Version 2.0.5 released.

Version 2.0.5 of Mosquitto has been released. This is a bugfix release.

Broker

  • Fix auth_method not being provided to the extended auth plugin event. Closes #1975.
  • Fix large packets not being completely published to slow clients. Closes #1977.
  • Fix bridge connection not relinquishing POLLOUT after messages are sent. Closes #1979.
  • Fix apparmor incorrectly denying access to /var/lib/mosquitto/mosquitto.db.new. Closes #1978.
  • Fix potential intermittent initial bridge connections when using poll().
  • Fix bind_interface option. Closes #1999.
  • Fix invalid behaviour in dynsec plugin if a group or client is deleted before a role that was attached to the group or client is deleted. Closes #1998.
  • Improve logging in dynsec addGroupRole command. Closes #2005.
  • Improve logging in dynsec addGroupClient command. Closes #2008.

Client library

  • Improve documentation around the _v5() and non-v5 functions, e.g. mosquitto_publish() and `mosquitto_publish_v5().

Build

  • install Makefile target should depend on all, not mosquitto, to ensure that man pages are always built. Closes #1989.
  • Fixes for lots of minor build warnings highlighted by Visual Studio.

Apps

  • Disallow control characters in mosquitto_passwd usernames.
  • Fix incorrect description in mosquitto_ctrl man page. Closes #1995.
  • Fix mosquitto_ctrl dynsec getGroup not showing roles. Closes #1997.

Version 2.0.3 released.

Version 2.0.3 of Mosquitto has been released. This is a bugfix release.

Security

  • Running mosquitto_passwd with the following arguments only mosquitto_passwd -b password_file username password would cause the username to be used as the password.

Broker

  • Fix excessive CPU use on non-Linux systems when the open file limit is set high. Closes #1947.
  • Fix LWT not being sent on client takeover when the existing session wasn't being continued. Closes #1946.
  • Fix bridges possibly not completing connections when WITH_ADNS is in use. Closes #1960.
  • Fix QoS 0 messages not being delivered if max_queued_messages was set to 0. Closes #1956.
  • Fix local bridges being disconnected on SIGHUP. Closes #1942.
  • Fix slow initial bridge connections for WITH_ADNS=no.

Clients

  • Fix mosquitto_sub being unable to terminate with Ctrl-C if a successful connection is not made. Closes #1957.

Apps

  • Fix mosquitto_passwd -b using username as password (not if -c is also used). Closes #1949.

Build

  • Fix install target when using WITH_CJSON=no. Closes #1938.
  • Fix generic docker build. Closes #1945.

Version 2.0.4 released.

Version 2.0.4 of Mosquitto has been released. This is a bugfix release.

Broker

  • Fix $SYS/broker/publish/messages/+ counters not being updated for QoS 1, 2 messages. Closes #1968.
  • mosquitto_connect_bind_async() and mosquitto_connect_bind_v5() should not reset the bind address option if called with bind_address == NULL.
  • Fix dynamic security configuration possibly not being reloaded on Windows only. Closes #1962.
  • Add more log messages for dynsec load/save error conditions.
  • Fix websockets connections blocking non-websockets connections on Windows. Closes #1934.

Build

  • Fix man pages not being built when using CMake. Closes #1969.

Version 2.0.2 released.

Version 2.0.2 and 2.0.1 of Mosquitto has been released. These are bugfix releases.

Version 2.0.2 fixes a build regression introduced in 2.0.1 when websockets support was enabled on non-Linux systems.

The 2.0.1 changes are below.

Broker

  • Fix websockets connections on Windows blocking subsequent connections. Closes #1934.
  • Fix DH group not being set for TLS connections, which meant ciphers using DHE couldn't be used. Closes #1925. Closes #1476.
  • Fix websockets listeners not causing the main loop not to wake up. Closes #1936.

Client library

  • Fix DH group not being set for TLS connections, which meant ciphers using DHE couldn't be used. Closes #1925. Closes #1476.

Apps

  • Fix mosquitto_passwd -U

Build

  • Fix cjson include paths.
  • Fix build using WITH_TLS=no when the openssl headers aren't available.
  • Distribute cmake/ and snap/ directories in tar.

Version 2.0.0 released.

The Mosquitto project is happy to announce the release of version 2.0! This is a big change with breaking behaviour changes in the broker. Users, packages and plugin authors should read migrating from 1.x to 2.0 to help with the changes.

Noteworthy changes

Mosquitto is now more secure by default and requires users to take an active decision in how they configure security on their broker, instead of possibly relying on the older very permissive behaviour, as well as dropping privileged access more quickly. More details are in migrating from 1.x to 2.0.

A new plugin interface has been introduced which goes beyond the existing authentication and access control plugin interface to offer more plugin capabilities, whilst being easier to develop for and easier to extend. More details will follow. Existing plugins are still supported, although plugin authors should look at migrating from 1.x to 2.0 to ensure their plugins remain compatible when compiled against Mosquitto 2.0 headers.

A new plugin has been introduced to provide client, group, and role based authentication and access control. The plugin configuration is managed over special topics and can be updated on the fly. It provides a flexible and straightforward means of configuring access to your broker. For more information, see [Dynamic Security plugin].

The broker performance has been improved, particularly for higher numbers of clients. We plan to run show some benchmarks to show the improvement.

A new utility, mosquitto_ctrl has been added for controlling aspects of a running broker. At the present this is limited to controlling the dynamic security plugin, but will be extended to other features in later releases.

Bridges now support MQTT v5.

The mosquitto command line clients have received a variety of small improvements. mosquitto_sub can now format its output in fixed column widths, for example, and filter its output randomly so you can keep an eye on the overall behaviour of a topic without having to see every message, for example.

Breaking changes

  • When the Mosquitto broker is run without configuring any listeners it will now bind to the loopback interfaces 127.0.0.1 and/or ::1. This means that only connections from the local host will be possible.

Running the broker as mosquitto or mosquitto -p 1883 will bind to the loopback interface.

Running the broker with a configuration file with no listeners configured will bind to the loopback interface with port 1883.

Running the broker with a listener defined will bind by default to 0.0.0.0 / :: and so will be accessible from any interface. It is still possible to bind to a specific address/interface.

If the broker is run as mosquitto -c mosquitto.conf -p 1884, and a listener is defined in the configuration file, then the port defined on the command line will be IGNORED, and no listener configured for it. - All listeners now default to allow_anonymous false unless explicitly set to true in the configuration file. This means that when configuring a listener the user must either configure an authentication and access control method, or set allow_anonymous true. When the broker is run without a configured listener, and so binds to the loopback interface, anonymous connections are allowed. - If Mosquitto is run on as root on a unix like system, it will attempt to drop privileges as soon as the configuration file has been read. This is in contrast to the previous behaviour where elevated privileges were only dropped after listeners had been started (and hence TLS certificates loaded) and logging had been started. The change means that clients will never be able to connect to the broker when it is running as root, unless the user explicitly sets it to run as root, which is not advised. It also means that all locations that the broker needs to access must be available to the unprivileged user. In particular those people using TLS certificates from Lets Encrypt will need to do something to allow Mosquitto to access those certificates. An example deploy renewal hook script to help with this is at misc/letsencrypt/mosquitto-copy.sh. The user that Mosquitto will change to are the one provided in the configuration, mosquitto, or nobody, in order of availability. - The pid_file option will now always attempt to write a pid file, regardless of whether the -d argument is used when running the broker. - The tls_version option now defines the minimum TLS protocol version to be used, rather than the exact version. Closes #1258. - The max_queued_messages option has been increased from 100 to 1000 by default, and now also applies to QoS 0 messages, when a client is connected. - The mosquitto_sub, mosquitto_pub, and mosquitto_rr clients will now load OS provided CA certificates by default if -L mqtts://... is used, or if the port is set to 8883 and no other CA certificates are loaded. - Minimum support libwebsockets version is now 2.4.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.

Client library features

  • Client no longer generates random client ids for v3.1.1 clients, these are now expected to be generated on the broker. This matches the behaviour for v5 clients. Closes #291.
  • Add support for connecting to brokers through Unix domain sockets.
  • Add mosquitto_property_identifier(), for retrieving the identifier integer for a property.
  • Add mosquitto_property_identifier_to_string() for converting a property identifier integer to the corresponding property name string.
  • Add mosquitto_property_next() to retrieve the next property in a list, for iterating over property lists.
  • mosquitto_pub now handles the MQTT v5 retain-available property by never setting the retain bit.
  • Added MOSQ_OPT_TCP_NODELAY, to allow disabling Nagle's algorithm on client sockets. Closes #1526.
  • Add mosquitto_ssl_get() to allow clients to access their SSL structure and perform additional verification.
  • Add MOSQ_OPT_BIND_ADDRESS to allow setting of a bind address independently of the mosquitto_connect*() call.
  • Add MOSQ_OPT_TLS_USE_OS_CERTS option, to instruct the client to load and trust OS provided CA certificates for use with TLS connections.

Client library fixes

  • Fix send quota being incorrecly reset on reconnect. Closes #1822.
  • Don't use logging until log mutex is initialised. Closes #1819.
  • Fix missing mach/mach_time.h header on OS X. Closes #1831.
  • Fix connect properties not being sent when the client automatically reconnects. Closes #1846.

Client features

  • Add timeout return code (27) for mosquitto_sub -W <secs> and mosquitto_rr -W <secs>. Closes #275.
  • Add support for connecting to brokers through Unix domain sockets with the --unix argument.
  • Use cJSON library for producing JSON output, where available. Closes #1222.
  • Add support for outputting MQTT v5 property information to mosquitto_sub/rr JSON output. Closes #1416.
  • Add --pretty option to mosquitto_sub/rr for formatted/unformatted JSON output.
  • Add support for v5 property printing to mosquitto_sub/rr in non-JSON mode. Closes #1416.
  • Add --nodelay to all clients to allow them to use the MOSQ_OPT_TCP_NODELAY option.
  • Add -x to all clients to all the session-expiry-interval property to be easily set for MQTT v5 clients.
  • Add --random-filter to mosquitto_sub, to allow only a certain proportion of received messages to be printed.
  • mosquitto_sub %j and %J timestamps are now in a ISO 8601 compatible format.
  • mosquitto_sub now supports extra format specifiers for field width and precision for some parameters.
  • Add --version for all clients.
  • All clients now load OS provided CA certificates if used with -L mqtts://..., or if port is set to 8883 and no other CA certificates are used. Closes #1824.
  • Add the --tls-use-os-certs option to all clients.

Client fixes

  • mosquitto_sub will now exit if all subscriptions were denied.
  • mosquitto_pub now sends 0 length files without an error when using -f.
  • Fix description of -e and -t arguments in mosquitto_rr. Closes #1881.
  • mosquitto_sub will now quit with an error if the %U option is used on Windows, rather than just quitting. Closes #1908.

Version 1.6.12 released.

Mosquitto 1.6.12 and 1.5.10 have been released.

Security

  • In some circumstances, Mosquitto could leak memory when handling PUBLISH messages. This is limited to incoming QoS 2 messages, and is related to the combination of the broker having persistence enabled, a clean session=false client, which was connected prior to the broker restarting, then has reconnected and has now sent messages at a sufficiently high rate that the incoming queue at the broker has filled up and hence messages are being dropped. This is more likely to have an effect where max_queued_messages is a small value. This has now been fixed. Closes #1793.

The following fixes apply to 1.6.12 only.

Broker

  • Build warning fixes when building with WITH_BRIDGE=no and WITH_TLS=no.

Clients

  • All clients exit with an error exit code on CONNACK failure. Closes #1778.
  • Don't busy loop with mosquitto_pub -l on a slow connection.

Version 1.6.11 released.

Mosquitto 1.6.11 has been released, this is a bugfix release.

Security

  • On Windows the Mosquitto service was being installed without appropriate path quoting, this has been fixed. Closes #565671.

Broker

  • Fix usage message only mentioning v3.1.1. Closes #1713.
  • Fix broker refusing to start if only websockets listeners were defined. Closes #1740.
  • Change systemd unit files to create /var/log/mosquitto before starting. Closes #821.
  • Don't quit with an error if opening the log file isn't possible. Closes #821.
  • Fix bridge topic remapping when using "" as the topic. Closes #1749.
  • Fix messages being queued for disconnected bridges when clean start was set to true. Closes #1729.
  • Fix autosave_interval not being triggered by messages being delivered. Closes #1726.
  • Fix websockets clients sometimes not being disconnected promptly. Closes #1718.
  • Fix "slow" file based logging by switching to line based buffering. Closes #1689. Closes #1741.
  • Log protocol error message where appropriate from a bad UNSUBSCRIBE, rather than the generic "socket error".
  • Don't try to start DLT logging if DLT unavailable, to avoid a long delay when shutting down the broker. Closes #1735.
  • Fix potential memory leaks. Closes #1773. Closes #1774.
  • Fix clients not receiving messages after a previous client with the same client ID and positive will delay interval quit. Closes #1752.
  • Fix overly broad HAVE_PTHREAD_CANCEL compile guard. Closes #1547.

Client library

  • Improved documentation around connect callback return codes. Close #1730.
  • Fix mosquitto_publish*() no longer returning MOSQ_ERR_NO_CONN when not connected. Closes #1725.
  • mosquitto_loop_start() now sets a thread name on Linux, FreeBSD, NetBSD, and OpenBSD. Closes #1777.
  • Fix mosquitto_loop_stop() not stopping on Windows. Closes #1748. Closes #117.