README Compiling

The following packages can be used to add features to mosquitto.

• cJSON - required
• c-ares (libc-ares-dev on Debian based systems) - optional, enable with WITH_SRV=yes
• libedit - for mosquitto_ctrl interactive shell - optional, disable with WITH_EDITLINE=no
• libmicrohttpd - for broker http api support - optional, disable with WITH_HTTP_API=no
• openssl (libssl-dev on Debian based systems) - optional, disable with WITH_TLS=no
• pthreads - for client library thread support. This is required to support the mosquitto_loop_start() and mosquitto_loop_stop() functions. If compiled without pthread support, the library isn't guaranteed to be thread safe.
• sqlite3 - for persistence support in the broker - optional, disable with WITH_SQLITE=no
• uthash / utlist - bundled versions of these headers are provided, disable their use with WITH_BUNDLED_DEPS=no
• xsltproc (xsltproc and docbook-xsl on Debian based systems) - only needed when building from git sources - disable with WITH_DOCS=no

For testing, the following packages are required:

• cunit
• googletest / gmock
• microsocks
• python

To compile you may either use CMake, or on Linux look in the file config.mk for compile options and use plain make.

Up to version 2.1, the recommendation was to use CMake for Windows and Mac, and to use make everywhere else. The recommendation now is to use cmake in all cases, and that the plain makefiles will be removed in version 3.0.

If you have any questions, problems or suggestions (particularly related to installing on a more unusual device) then please get in touch using the details in README.md.