C Python C++ Makefile CMake NSIS Other
Clone or download
Latest commit 75fc908 Jun 15, 2018
Permalink
Failed to load latest commit information.
client Fix static mosquitto_sub compiling. May 1, 2018
doc JOSS paper. May 17, 2017
docker 1.4.14 support for docker (#500) Jul 26, 2017
examples Merge branch 'fixes' into develop Feb 13, 2018
installer Bump version number. May 2, 2018
lib Merge branch 'develop' May 3, 2018
logo Improve logo files. Oct 5, 2016
man Merge branch 'develop' May 3, 2018
misc/currentcost Merge branch 'master' into develop Jun 21, 2016
security Fix apparmor profile to match debian packaging. Jul 28, 2014
service Add default config path to systemd services. (#139) Apr 19, 2016
snap Fix snap launcher path. Jun 15, 2018
src Merge branch 'develop' May 3, 2018
test Updated crude performance test. May 2, 2018
.gitignore Separate the C and C++ static libraries. Jun 15, 2016
.travis.yml Fix some defects discovered by coverity. Mar 18, 2016
CMakeLists.txt Bump version number. May 2, 2018
CONTRIBUTING.md Check client topic inputs for valid UTF-8. Jun 20, 2016
ChangeLog.txt Merge branch 'develop' May 3, 2018
LICENSE.txt Initial contribution. May 7, 2014
Makefile Merge branch 'develop' May 3, 2018
Mosquitto.podspec Change pod name to Mosquitto May 28, 2016
THANKS.txt Merge branch 'master' into develop Mar 6, 2017
about.html Eclipse required files. May 8, 2014
aclfile.example Initial contribution. May 7, 2014
appveyor.yml Update appveyor to take into account now available packages. Apr 12, 2018
compiling.txt Merge branch 'develop' May 3, 2018
config.h Fix build warnings on Mac. May 2, 2018
config.mk Static websockets option. May 18, 2018
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 support for openssl 1.0.0 and 1.0.1. Apr 11, 2018
notice.html Eclipse required files. May 8, 2014
pskfile.example Initial contribution. May 7, 2014
pwfile.example Initial contribution. May 7, 2014
readme-windows.txt Updated readme.md. Jul 12, 2016
readme.md Amend xsltproc dep docs. Jan 12, 2018
set-version.sh Merge branch 'develop' May 3, 2018
travis-configure.sh Travis helpers. Jun 7, 2016
travis-install.sh broker: support byte based queueing Sep 9, 2016

readme.md

Eclipse Mosquitto

Mosquitto is an open source implementation of a server for version 3.1 and 3.1.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 http://test.mosquitto.org/

Installing

See http://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 http://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 http://mosquitto.org/api/

Building from source

To build from source the recommended route for end users is to download the archive from http://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) - disable with make WITH_SRV=no
  • libuuid (uuid-dev) - disable with make WITH_UUID=no
  • 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

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)