Cloned from GitHub



Roger A. Light: 23230b7b18 Add per-listener acl handling. 3 months ago
client 3c517e617c Fix static mosquitto_sub compiling. 3 months ago
doc c79d48c0c3 JOSS paper. 1 year ago
docker d5e8217d20 1.4.14 support for docker (#500) 1 year ago
examples 81cb7ab547 Merge branch 'fixes' into develop 6 months ago
installer f5f1a64d40 Consistent installer naming. 2 years ago
lib 79a7b36d20 Don't derefence a null message. 3 months ago
logo 51bfdc9ed4 Improve logo files. 1 year ago
man a50d7c7f04 pub/sub typo. 4 months ago
misc 1c3988a397 Merge branch 'master' into develop 2 years ago
security 06d5e000f1 Fix apparmor profile to match debian packaging. 4 years ago
service fe93138197 Add default config path to systemd services. (#139) 2 years ago
snap 4c43f4ce64 Snaps also need docbook-xsl. 1 year ago
src 23230b7b18 Add per-listener acl handling. 3 months ago
test ba71bc3b32 Experimental parallel testing for library. 4 months ago
.gitignore fa2d3143a4 Separate the C and C++ static libraries. 2 years ago
.travis.yml 37dceb38f9 Fix some defects discovered by coverity. 2 years ago
CMakeLists.txt 2283585e39 Remove build timestamp information for reproducible builds. 7 months ago
CONTRIBUTING.md a8a5daf06b Check client topic inputs for valid UTF-8. 2 years ago
ChangeLog.txt 23230b7b18 Add per-listener acl handling. 3 months ago
LICENSE.txt 0364bd1be7 Initial contribution. 4 years ago
Makefile a29ee5db23 Uninstall the actually installed config file. 4 months ago
Mosquitto.podspec afdb83c32a Change pod name to Mosquitto 2 years ago
THANKS.txt 91b308a11d Merge branch 'master' into develop 1 year ago
about.html 2669979502 Eclipse required files. 4 years ago
aclfile.example 0364bd1be7 Initial contribution. 4 years ago
appveyor.yml 90d9831e73 Update appveyor to take into account now available packages. 4 months ago
compiling.txt 4c147309a4 Minimum supported libwebsockets version is now 1.3. 3 years ago
config.h 62d99ecbc2 Build fixes. 3 months ago
config.mk 406c67e6f8 Don't pass -std=c99 to C++ build. 4 months ago
edl-v10 0364bd1be7 Initial contribution. 4 years ago
epl-v10 0364bd1be7 Initial contribution. 4 years ago
libmosquitto.pc.in 97bfa506db Add pkg-config files to CMake build (#213) 1 year ago
libmosquittopp.pc.in 97bfa506db Add pkg-config files to CMake build (#213) 1 year ago
mosquitto.conf 24d68b5af8 Remove support for openssl 1.0.0 and 1.0.1. 4 months ago
notice.html 2669979502 Eclipse required files. 4 years ago
pskfile.example 0364bd1be7 Initial contribution. 4 years ago
pwfile.example 0364bd1be7 Initial contribution. 4 years ago
readme-windows.txt 3261b307e3 Updated readme.md. 2 years ago
readme.md c4f8bee34c Amend xsltproc dep docs. 7 months ago
set-version.sh 1fa4d74278 Bump version number. 1 year ago
travis-configure.sh 70f2bea51f Merging travis config changes across branches. 2 years ago
travis-install.sh c6aac741c2 broker: support byte based queueing 1 year 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)