Eclipse Mosquitto - An open source MQTT broker
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Go to file
Roger A. Light 8795f063d4 Add ability to deny access to SUBSCRIBE messages.
This is as well as the current read/write accesses. Currently for auth
plugins only.
8 years ago
client Default to mqtt v3.1.1 for clients. 8 years ago
doc JOSS paper. 8 years ago
docker 1.4.14 support for docker (#500) 8 years ago
examples Improve example. 10 years ago
installer Bump version number. 8 years ago
lib Update UTF-8 validation checks. 8 years ago
logo Improve logo files. 9 years ago
man Fix man page typo. 8 years ago
misc/currentcost Merge branch 'master' into develop 9 years ago
security Fix apparmor profile to match debian packaging. 11 years ago
service Add default config path to systemd services. (#139) 10 years ago
snap Snaps also need docbook-xsl. 9 years ago
src Add ability to deny access to SUBSCRIBE messages. 8 years ago
test Update UTF-8 validation checks. 8 years ago
.gitignore Separate the C and C++ static libraries. 9 years ago
.travis.yml Fix some defects discovered by coverity. 10 years ago
CMakeLists.txt Bump version number. 8 years ago
CONTRIBUTING.md Check client topic inputs for valid UTF-8. 9 years ago
ChangeLog.txt Add ability to deny access to SUBSCRIBE messages. 8 years ago
LICENSE.txt Initial contribution. 12 years ago
Makefile Make target for building API docs. 9 years ago
Mosquitto.podspec Change pod name to Mosquitto 9 years ago
THANKS.txt Merge branch 'master' into develop 9 years ago
about.html Eclipse required files. 12 years ago
aclfile.example Initial contribution. 12 years ago
appveyor.yml Merge branch 'master' into develop 8 years ago
compiling.txt Minimum supported libwebsockets version is now 1.3. 10 years ago
config.h Merge branch 'master' into develop 9 years ago
config.mk Enable epoll() by default on Linux. 8 years ago
edl-v10 Initial contribution. 12 years ago
epl-v10 Initial contribution. 12 years ago
libmosquitto.pc.in Add pkg-config files to CMake build (#213) 9 years ago
libmosquittopp.pc.in Add pkg-config files to CMake build (#213) 9 years ago
mosquitto.conf [462] Add auth_plugin_deny_special_chars option. 8 years ago
notice.html Eclipse required files. 12 years ago
pskfile.example Initial contribution. 12 years ago
pwfile.example Initial contribution. 12 years ago
readme-windows.txt Updated readme.md. 9 years ago
readme.md Fix documentation type WITH_DNS_SRV. 9 years ago
set-version.sh Bump version number. 8 years ago
travis-configure.sh Travis helpers. 9 years ago
travis-install.sh broker: support byte based queueing 9 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.

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

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)