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 0c22f475ff Fix bridges incorrectly setting Wills to manage remote notifications.
This is for when `notifications_local_only` was set true.

Closes #1902. Thanks to marcinkowskip.
5 years ago
.github Try alternative flow for cov sync. 5 years ago
apps ctrl: Add warning if connecting without encryption. 5 years ago
client Build fix for WITH_TLS=no. 5 years ago
cmake New dynamic security plugin. 5 years ago
deps Move deps directory to root. 5 years ago
doc JOSS paper. 8 years ago
docker New dynamic security plugin. 5 years ago
examples Merge remote-tracking branch 'origin/fixes' into develop 5 years ago
include Add lib and client support for OS CA certs 5 years ago
installer Consistency in readme naming. 5 years ago
lib Fix bridges incorrectly setting Wills to manage remote notifications. 5 years ago
logo Improve logo files. 9 years ago
man Add lib and client support for OS CA certs 5 years ago
misc Breaking: Drop privileges after loading the configuration 5 years ago
plugins dynsec: Fix logging args. 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 Bump version, add new www posts. 5 years ago
src Fix bridges incorrectly setting Wills to manage remote notifications. 5 years ago
test Fix mosq_test.py to_string() on Python 3 5 years ago
www Point Windows users to older installers if needed. 5 years ago
.gitignore Ignore windows 64 bit build dir. 5 years ago
.travis.yml Travis: Use bionic distro. 6 years ago
CMakeLists.txt CMake: add options about whether to build the apps and plugins 5 years ago
COMPILING.md Consistency in readme naming. 5 years ago
CONTRIBUTING.md Fix link in CONTRIBUTING.md. 6 years ago
ChangeLog.txt Fix bridges incorrectly setting Wills to manage remote notifications. 5 years ago
LICENSE.txt Update to EPL-2.0 5 years ago
Makefile Consistency in readme naming. 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 Support cJSON < 1.7.13. 5 years ago
config.mk Integrate debugging only xtreport code. 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 Add `ciphers_tls1.3` option, to allow setting TLS v1.3 ciphersuites. 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, add new www posts. 5 years ago
travis-configure.sh Better attempt at fixing mac travis. 7 years ago
travis-install.sh Attempt to fix travis on osx and unreliable test. 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)