Eclipse Mosquitto - An open source MQTT broker
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Go to file
Roger A. Light b7f0161f52 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.
5 years ago
.github Try alternative flow for cov sync. 5 years ago
apps Fix `mosquitto_passwd -U` 5 years ago
client Fix cjson include paths. 5 years ago
cmake Fix cjson include paths. 5 years ago
deps Move deps directory to root. 5 years ago
doc JOSS paper. 8 years ago
docker Docker: Verify sha256 sums for lws/cjson. 5 years ago
examples Merge remote-tracking branch 'origin/fixes' into develop 5 years ago
include Bump version number and changelog. 5 years ago
installer Windows installer path fixes. 5 years ago
lib Fixed some VS2017 compilation error and warnings (#1916) 5 years ago
logo Improve logo files. 9 years ago
man Bridge support for MQTT v5 maximum-qos. 5 years ago
misc Breaking: Drop privileges after loading the configuration 5 years ago
plugins Drop hard coded linker flags. 5 years ago
security Fix apparmor profile to match debian packaging. 11 years ago
service Change systemd unit files to create /var/log/mosquitto 5 years ago
snap Fix cjson include paths. 5 years ago
src Fix DH group not being set for TLS connections. 5 years ago
test Bridge support for MQTT v5 maximum-qos. 5 years ago
www Remove defunct stickers link. 5 years ago
.gitignore Ignore windows 64 bit build dir. 5 years ago
.travis.yml Travis: Use bionic distro. 6 years ago
CMakeLists.txt Bump version number and changelog. 5 years ago
CONTRIBUTING.md Fix link in CONTRIBUTING.md. 6 years ago
ChangeLog.txt Fix DH group not being set for TLS connections. 5 years ago
LICENSE.txt Update to EPL-2.0 5 years ago
Makefile Distribute cmake/ and snap/ directories in tar. 5 years ago
README-compiling.md Rename and update. 5 years ago
README-letsencrypt.md Breaking: Drop privileges after loading the configuration 5 years ago
README-tests.md Consistency in readme naming. 5 years ago
README-windows.txt Consistency in readme naming. 5 years ago
README.md Consistency in readme naming. 5 years ago
SECURITY.md Add SECURITY.md. 6 years ago
THANKS.txt Merge branch 'master' into develop 9 years ago
about.html Update to EPL-2.0 5 years ago
aclfile.example Initial contribution. 12 years ago
appveyor.yml Update appveyor to take into account now available packages. 8 years ago
buildtest.py Better outgoing QoS 0 limiting. 5 years ago
config.h Fix cjson include paths. 5 years ago
config.mk Drop hard coded linker flags. 5 years ago
edl-v10 Initial contribution. 12 years ago
epl-v20 Update to EPL-2.0 5 years ago
libmosquitto.pc.in Add pkg-config files to CMake build (#213) 9 years ago
libmosquittopp.pc.in Add pkg-config files to CMake build (#213) 9 years ago
mosquitto.conf Bridge support for MQTT v5 maximum-qos. 5 years ago
notice.html Update to EPL-2.0 5 years ago
pskfile.example Initial contribution. 12 years ago
pwfile.example Initial contribution. 12 years ago
set-version.sh Bump version number and changelog. 5 years ago
travis-configure.sh Better attempt at fixing mac travis. 7 years ago
travis-install.sh Don't update homebrew in travis, it takes an age otherwise. 5 years ago

README.md

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)