2026-05-13 20:36:01 +02:00
|
|
|
The following packages can be used to add features to mosquitto. See below for
|
|
|
|
|
platform specific package lists.
|
2014-05-08 00:27:00 +02:00
|
|
|
|
2025-09-26 17:03:15 +02:00
|
|
|
* 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`
|
2014-05-08 00:27:00 +02:00
|
|
|
|
2026-01-16 15:08:41 +01:00
|
|
|
For testing, the following packages are required:
|
|
|
|
|
* cunit
|
|
|
|
|
* googletest / gmock
|
|
|
|
|
* microsocks
|
|
|
|
|
* python
|
|
|
|
|
|
|
|
|
|
|
2025-09-26 17:03:15 +02:00
|
|
|
To compile you may either use CMake, or on Linux look in the file `config.mk`
|
|
|
|
|
for compile options and use plain `make`.
|
2014-05-08 00:27:00 +02:00
|
|
|
|
2025-09-26 17:03:15 +02:00
|
|
|
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.
|
2014-05-08 00:27:00 +02:00
|
|
|
|
|
|
|
|
If you have any questions, problems or suggestions (particularly related to
|
2020-11-12 23:08:38 +01:00
|
|
|
installing on a more unusual device) then please get in touch using the details
|
|
|
|
|
in README.md.
|
2026-05-13 20:36:01 +02:00
|
|
|
|
|
|
|
|
## Platform specific dependencies
|
|
|
|
|
|
|
|
|
|
### Alpine Linux
|
|
|
|
|
|
|
|
|
|
apk add cjson-dev cmake cunit-dev docbook-xsl g++ gcc gtest-dev libmicrohttpd-dev \
|
|
|
|
|
libxslt make musl-dev openssl-dev sqlite-dev
|
|
|
|
|
|
|
|
|
|
### Fedora Linux
|
|
|
|
|
|
|
|
|
|
dnf install CUnit-devel cjson-devel cmake docbook-style-xsl gcc gcc-g++ gmock-devel \
|
|
|
|
|
gtest-devel libmicrohttpd-devel libxslt openssl-devel openssl-devel-engine sqlite-devel
|
|
|
|
|
|
|
|
|
|
### FreeBSD
|
|
|
|
|
|
|
|
|
|
pkg install cunit gmake googletest libcjson libmicrohttpd libxslt python3 sqlite3 uthash
|
|
|
|
|
|
|
|
|
|
### Ubuntu Linux
|
|
|
|
|
|
|
|
|
|
apt install cmake docbook-xsl gcc g++ libcjson-dev libcunit1-dev libeditreadline-dev \
|
|
|
|
|
libgmock-dev libgtest-dev libmicrohttpd-dev libsqlite3-dev libssl-dev xsltproc
|
