Go to file
Roger A. Light d8dcfd75fe lib: Fix DH group not being set for TLS connections.
This meant ciphers using DHE couldn't be used.

Closes #1925. Closes #1476. Thanks to Jonathan Sönnerup, Valerii
Demeshko, and sectokia.
2020-12-09 22:30:06 +00:00
.github Try alternative flow for cov sync. 2020-11-24 10:09:30 +00:00
apps Fix mosquitto_passwd -U 2020-12-09 14:08:37 +00:00
client Fix cjson include paths. 2020-12-04 22:15:19 +00:00
cmake Fix cjson include paths. 2020-12-04 22:15:19 +00:00
deps Move deps directory to root. 2020-10-13 16:06:06 +01:00
doc JOSS paper. 2017-05-17 14:56:28 +01:00
docker Docker: Verify sha256 sums for lws/cjson. 2020-12-03 21:07:01 +00:00
examples Merge remote-tracking branch 'origin/fixes' into develop 2020-09-24 17:03:14 +01:00
include Bump version number and changelog. 2020-12-02 20:54:13 +00:00
installer Windows installer path fixes. 2020-12-03 14:02:43 +00:00
lib lib: Fix DH group not being set for TLS connections. 2020-12-09 22:30:06 +00:00
logo Improve logo files. 2016-10-05 15:52:09 +01:00
man Bridge support for MQTT v5 maximum-qos. 2020-12-01 18:15:29 +00:00
misc Breaking: Drop privileges after loading the configuration 2020-11-05 12:05:07 +00:00
plugins Drop hard coded linker flags. 2020-12-06 07:43:59 +00:00
security Fix apparmor profile to match debian packaging. 2014-07-28 09:22:20 +01:00
service Change systemd unit files to create /var/log/mosquitto 2020-07-14 20:10:54 +01:00
snap Fix cjson include paths. 2020-12-04 22:15:19 +00:00
src Fix DH group not being set for TLS connections. 2020-12-09 15:40:45 +00:00
test Bridge support for MQTT v5 maximum-qos. 2020-12-01 18:15:29 +00:00
www Remove defunct stickers link. 2020-12-09 14:08:37 +00:00
.gitignore Ignore windows 64 bit build dir. 2020-11-17 10:21:58 +00:00
.travis.yml Travis: Use bionic distro. 2020-03-27 00:07:48 +00:00
about.html Update to EPL-2.0 2020-11-25 17:34:21 +00:00
aclfile.example Initial contribution. 2014-05-07 23:27:00 +01:00
appveyor.yml Update appveyor to take into account now available packages. 2018-04-12 10:30:52 +01:00
buildtest.py Better outgoing QoS 0 limiting. 2020-11-25 10:00:45 +00:00
ChangeLog.txt lib: Fix DH group not being set for TLS connections. 2020-12-09 22:30:06 +00:00
CMakeLists.txt Bump version number and changelog. 2020-12-02 20:54:13 +00:00
config.h Fix cjson include paths. 2020-12-04 22:15:19 +00:00
config.mk Drop hard coded linker flags. 2020-12-06 07:43:59 +00:00
CONTRIBUTING.md Fix link in CONTRIBUTING.md. 2019-08-01 10:30:13 +01:00
edl-v10 Initial contribution. 2014-05-07 23:27:00 +01:00
epl-v20 Update to EPL-2.0 2020-11-25 17:34:21 +00:00
libmosquitto.pc.in Add pkg-config files to CMake build (#213) 2016-09-10 21:48:50 +01:00
libmosquittopp.pc.in Add pkg-config files to CMake build (#213) 2016-09-10 21:48:50 +01:00
LICENSE.txt Update to EPL-2.0 2020-11-25 17:34:21 +00:00
Makefile Distribute cmake/ and snap/ directories in tar. 2020-12-06 23:12:04 +00:00
mosquitto.conf Bridge support for MQTT v5 maximum-qos. 2020-12-01 18:15:29 +00:00
notice.html Update to EPL-2.0 2020-11-25 17:34:21 +00:00
pskfile.example Initial contribution. 2014-05-07 23:27:00 +01:00
pwfile.example Initial contribution. 2014-05-07 23:27:00 +01:00
README-compiling.md Rename and update. 2020-12-03 00:06:21 +00:00
README-letsencrypt.md Breaking: Drop privileges after loading the configuration 2020-11-05 12:05:07 +00:00
README-tests.md Consistency in readme naming. 2020-11-12 22:08:38 +00:00
README-windows.txt Consistency in readme naming. 2020-11-12 22:08:38 +00:00
README.md Consistency in readme naming. 2020-11-12 22:08:38 +00:00
SECURITY.md Add SECURITY.md. 2019-05-29 11:02:34 +01:00
set-version.sh Bump version number and changelog. 2020-12-02 20:54:13 +00:00
THANKS.txt Merge branch 'master' into develop 2017-03-06 21:19:53 +00:00
travis-configure.sh Better attempt at fixing mac travis. 2018-09-25 14:25:02 +01:00
travis-install.sh Don't update homebrew in travis, it takes an age otherwise. 2020-12-04 23:23:58 +00:00

Eclipse Mosquitto

Mosquitto is an open source implementation of a server for version 5.0, 3.1.1, and 3.1 of the MQTT protocol. It also includes a C and C++ client library, and the mosquitto_pub and mosquitto_sub utilities for publishing and subscribing.

See the following links for more information on MQTT:

Mosquitto project information is available at the following locations:

There is also a public test server available at https://test.mosquitto.org/

Installing

See https://mosquitto.org/download/ for details on installing binaries for various platforms.

Quick start

If you have installed a binary package the broker should have been started automatically. If not, it can be started with a basic configuration:

mosquitto

Then use mosquitto_sub to subscribe to a topic:

mosquitto_sub -t 'test/topic' -v

And to publish a message:

mosquitto_pub -t 'test/topic' -m 'hello world'

Documentation

Documentation for the broker, clients and client library API can be found in the man pages, which are available online at https://mosquitto.org/man/. There are also pages with an introduction to the features of MQTT, the mosquitto_passwd utility for dealing with username/passwords, and a description of the configuration file options available for the broker.

Detailed client library API documentation can be found at https://mosquitto.org/api/

Building from source

To build from source the recommended route for end users is to download the archive from https://mosquitto.org/download/.

On Windows and Mac, use cmake to build. On other platforms, just run make to build. For Windows, see also README-windows.md.

If you are building from the git repository then the documentation will not already be built. Use make binary to skip building the man pages, or install docbook-xsl on Debian/Ubuntu systems.

Build Dependencies

  • c-ares (libc-ares-dev on Debian based systems) - only when compiled with make WITH_SRV=yes
  • libwebsockets (libwebsockets-dev) - enable with make WITH_WEBSOCKETS=yes
  • openssl (libssl-dev on Debian based systems) - disable with make WITH_TLS=no
  • xsltproc (xsltproc and docbook-xsl on Debian based systems) - only needed when building from git sources - disable with make WITH_DOCS=no
  • uthash / utlist - bundled versions of these headers are provided, disable their use with make WITH_BUNDLED_DEPS=no
  • cJSON - for client JSON output support. Disable with make WITH_CJSON=no Auto detected with CMake.

Equivalent options for enabling/disabling features are available when using the CMake build.

Credits

Mosquitto was written by Roger Light roger@atchoo.org

Master: Travis Build Status (master) Develop: Travis Build Status (develop) Fixes: Travis Build Status (fixes)