Mosquitto
C Python C++ Makefile HTML NSIS Other
Latest commit a8194f0 Jan 21, 2017 @bogdal bogdal committed with ralight Update docker config path (#349)
Signed-off-by: Adam Bogdał <adam@bogdal.pl>
Permalink
Failed to load latest commit information.
client Incorrect quoting. Mar 13, 2016
doc/historical Initial contribution. May 7, 2014
docker Update docker config path (#349) Jan 21, 2017
examples Fix example for libmosquittopp virtual destructor change. Feb 8, 2015
installer Bump version number. Aug 16, 2016
lib Bump version number. Aug 16, 2016
logo Improve logo files. Oct 5, 2016
man [225] Fix typo in man page. Aug 8, 2016
misc/currentcost Fix minor test problems highlighted by codacy.com. Apr 9, 2016
security Fix apparmor profile to match debian packaging. Jul 28, 2014
service Match upstart prefix to default config.mk. Sep 21, 2014
src Merge branch 'fixes' Aug 16, 2016
test Fix mosquitto_topic_matches_sub(). Jun 2, 2016
.gitignore Use hash for message store to speed up loading. Nov 17, 2014
.travis.yml Merging travis config changes across branches. Mar 15, 2016
CMakeLists.txt Bump version number. Aug 16, 2016
CONTRIBUTING.md Merge branch 'fixes' Jun 2, 2016
ChangeLog.txt Bump version number. Aug 16, 2016
LICENSE.txt Initial contribution. May 7, 2014
Makefile [184] Don't attempt to install docs when WITH_DOCS=no. Jun 6, 2016
Mosquitto.podspec Change pod name to Mosquitto May 28, 2016
THANKS.txt Update changelog. Jul 12, 2016
about.html Eclipse required files. May 8, 2014
aclfile.example Initial contribution. May 7, 2014
appveyor.yml Bump appveyor openssl version. Jun 7, 2016
compiling.txt Add dependencies to compiling.txt. Oct 31, 2014
config.h Fix building on Visual Studio 2015 Mar 17, 2016
config.mk Bump version number. Aug 16, 2016
edl-v10 Initial contribution. May 7, 2014
epl-v10 Initial contribution. May 7, 2014
mosquitto.conf [170] Fix WS listeners not being able to bind to an IP. May 26, 2016
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 Merge branch 'fixes' Aug 16, 2016
set-version.sh Bump version number. Jun 2, 2016
travis-configure.sh Travis helpers. Jun 7, 2016
travis-install.sh Travis helpers. Jun 7, 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-ares2-dev on Debian based systems) - disable with make WITH_DNS_SRV=no
  • libuuid (uuid-dev) - disable with make WITH_UUID=no
  • libwebsockets (libwebsockets-dev) - enable with make WITH_LIBWEBSOCKETS=yes
  • openssl (libssl-dev on Debian based systems) - disable with make WITH_TLS=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)