Skip to content
Eclipse Mosquitto - An open source MQTT broker
C Python C++ Makefile HTML CMake Other
Branch: master
Clone or download

Latest commit

ralight Docker: update to 1.6.10.
Also:

* Update to alpine:3.12.
* Use openssl.
* Enable TLS-PSK.
* Remove obsolete 1.4.12 dockerfile.
Latest commit f39bf49 Jun 2, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Updated pull rqeuest text. Mar 19, 2020
client Fix mosquitto_sub %j or %J not working on Windows. May 6, 2020
doc JOSS paper. May 17, 2017
docker Docker: update to 1.6.10. Jun 2, 2020
examples Merge branch 'fixes' into develop Feb 13, 2018
installer Update changelog and version. May 25, 2020
lib Update changelog and version. May 25, 2020
logo Improve logo files. Oct 5, 2016
man Missing / in bridge remapping doc. Mar 31, 2020
misc/currentcost Merge branch 'master' into develop Jun 21, 2016
security Fix apparmor profile to match debian packaging. Jul 28, 2014
service mosquitto.service: mosquitto starts even if the network is offline Mar 12, 2020
snap Update changelog and version. May 25, 2020
src Fix possible assert crash associated with bridge reconnecting. May 25, 2020
test Improve client test for unexpected pubrel. May 5, 2020
www Release post. May 25, 2020
.gitignore Add `testing` target for compiling test client fixes. Jan 2, 2020
.travis.yml Don't allow mac build failures. Apr 17, 2019
CMakeLists.txt Update changelog and version. May 25, 2020
CONTRIBUTING.md Fix link in CONTRIBUTING.md. Aug 1, 2019
ChangeLog.txt Update changelog and version. May 25, 2020
LICENSE.txt Initial contribution. May 7, 2014
Makefile Man pages generated as part of web page, so no need to copy. May 25, 2020
Mosquitto.podspec Change pod name to Mosquitto May 28, 2016
SECURITY.md Add SECURITY.md. May 29, 2019
THANKS.txt Merge branch 'master' into develop Mar 6, 2017
about.html Installer and readme updates. Aug 16, 2018
aclfile.example Initial contribution. May 7, 2014
appveyor.yml Update appveyor to take into account now available packages. Apr 12, 2018
buildtest.py Add rewritten build test script and remove some build warnings. Feb 12, 2019
compiling.txt Improve broker generated client ids for the non-Linux case. Dec 5, 2018
config.h Don't define _GNU_SOURCE where already defined. Closes #1357. Jul 25, 2019
config.mk Update changelog and version. May 25, 2020
edl-v10 Initial contribution. May 7, 2014
epl-v10 Initial contribution. May 7, 2014
libmosquitto.pc.in Add pkg-config files to CMake build (#213) Sep 10, 2016
libmosquittopp.pc.in Add pkg-config files to CMake build (#213) Sep 10, 2016
mosquitto.conf Remove obsolete `store_clean_interval` from documentation. Jun 6, 2019
notice.html Eclipse required files. May 8, 2014
pskfile.example Initial contribution. May 7, 2014
pwfile.example Initial contribution. May 7, 2014
readme-tests.md Add `make check` and document testing procedure. Apr 26, 2019
readme-windows.txt Allow other apps access to log file on Windows. Jul 3, 2019
readme.md Fix location of readme-windows.txt Aug 1, 2019
set-version.sh Update changelog and version. May 25, 2020
travis-configure.sh Better attempt at fixing mac travis. Sep 25, 2018
travis-install.sh Improve broker generated client ids for the non-Linux case. Dec 5, 2018

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.

Links

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.txt.

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

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)

You can’t perform that action at this time.