Cloned from GitHub



Roger A. Light: f47b565831 Bump version numbers, update changelog. 2 months ago
.github ebf4d3a920 Add github pull request template. 1 year ago
client ce31269e05 Update changelog, bump version, bump copyright year. 9 months ago
doc c79d48c0c3 JOSS paper. 2 years ago
docker ff36baa49e Bump Docker version. 10 months ago
examples 81cb7ab547 Merge branch 'fixes' into develop 1 year ago
installer f47b565831 Bump version numbers, update changelog. 2 months ago
lib f47b565831 Bump version numbers, update changelog. 2 months ago
logo 51bfdc9ed4 Improve logo files. 3 years ago
man 8350956a08 Make include_dir sort usefully case sensitive. 10 months ago
misc 1c3988a397 Merge branch 'master' into develop 3 years ago
security 06d5e000f1 Fix apparmor profile to match debian packaging. 5 years ago
service 79baa4968d Add documentation and networking dep to unit files 1 year ago
snap f47b565831 Bump version numbers, update changelog. 2 months ago
src 84681d9728 Restrict topic hierarchy to 200 levels to prevent possible stack overflow. 2 months ago
test 84681d9728 Restrict topic hierarchy to 200 levels to prevent possible stack overflow. 2 months ago
www ae309b331c Update webpage for 1.5.8 release. 9 months ago
.gitignore 8aef00d3df Add website. 1 year ago
.travis.yml d20355c8ac Merging travis config changes across branches. 3 years ago
CMakeLists.txt f47b565831 Bump version numbers, update changelog. 2 months ago
CONTRIBUTING.md 5898cc9aee update links for signing ECA, fix indentation 1 year ago
ChangeLog.txt f47b565831 Bump version numbers, update changelog. 2 months ago
LICENSE.txt 0364bd1be7 Initial contribution. 5 years ago
Makefile 5e60136449 Merge branch 'develop' 1 year ago
Mosquitto.podspec afdb83c32a Change pod name to Mosquitto 3 years ago
THANKS.txt 91b308a11d Merge branch 'master' into develop 2 years ago
about.html cbd7a70408 Installer and readme updates. 1 year ago
aclfile.example 0364bd1be7 Initial contribution. 5 years ago
appveyor.yml 90d9831e73 Update appveyor to take into account now available packages. 1 year ago
buildtest.py 9999faf9da Add rewritten build test script and remove some build warnings. 10 months ago
compiling.txt 8949200216 Documentation fixes. 1 year ago
config.h a00dd29af8 Fix building where TLS-PSK is not available. 1 year ago
config.mk f47b565831 Bump version numbers, update changelog. 2 months ago
edl-v10 0364bd1be7 Initial contribution. 5 years ago
epl-v10 0364bd1be7 Initial contribution. 5 years ago
libmosquitto.pc.in 97bfa506db Add pkg-config files to CMake build (#213) 3 years ago
libmosquittopp.pc.in 97bfa506db Add pkg-config files to CMake build (#213) 3 years ago
mosquitto.conf 8350956a08 Make include_dir sort usefully case sensitive. 10 months ago
notice.html 2669979502 Eclipse required files. 5 years ago
pskfile.example 0364bd1be7 Initial contribution. 5 years ago
pwfile.example 0364bd1be7 Initial contribution. 5 years ago
readme-windows.txt cbd7a70408 Installer and readme updates. 1 year ago
readme.md c4f8bee34c Amend xsltproc dep docs. 1 year ago
set-version.sh f47b565831 Bump version numbers, update changelog. 2 months ago
travis-configure.sh 9200a8e98b Better attempt at fixing mac travis. 1 year ago
travis-install.sh c6aac741c2 broker: support byte based queueing 3 years ago

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)