Cloned from GitHub



Roger A. Light: 4555ee79e5 Web page update. 3 months ago
.github ebf4d3a920 Add github pull request template. 11 months ago
client 4dcd977932 Windows build fixes. 3 months ago
doc c79d48c0c3 JOSS paper. 2 years ago
docker 2d360fd495 Update Dockerfile for 1.5.8. 4 months ago
examples 81cb7ab547 Merge branch 'fixes' into develop 1 year ago
installer 56757df512 Bump version and changelog details. 3 months ago
lib 4dcd977932 Windows build fixes. 3 months ago
logo 51bfdc9ed4 Improve logo files. 2 years ago
man 4995436b5a Add --repeat and --repeat-delay to mosquitto_pub. 3 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 e4db8707a6 Add ExecReload stanza to systemd units files. 3 months ago
snap 56757df512 Bump version and changelog details. 3 months ago
src 4dcd977932 Windows build fixes. 3 months ago
test 17eae08c5e Test build fixes. 3 months ago
www 4555ee79e5 Web page update. 3 months ago
.gitignore 5b7b5ea158 Ignore some valgrind output files. 3 months ago
.travis.yml 2844256087 Don't allow mac build failures. 3 months ago
CMakeLists.txt 56757df512 Bump version and changelog details. 3 months ago
CONTRIBUTING.md ec3fd361be https links where possible. 3 months ago
ChangeLog.txt 449103e960 Merge remote-tracking branch 'refs/remotes/origin/fixes' 3 months ago
LICENSE.txt 0364bd1be7 Initial contribution. 5 years ago
Makefile 72941db546 Coverity fixes 4 months 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. 11 months 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. 5 months ago
compiling.txt 1d3949bce0 Improve broker generated client ids for the non-Linux case. 7 months ago
config.h 2dd24449ad Fix "unused parameter" warnings. 4 months ago
config.mk 947218c975 Fix build when external utlist not available. 3 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) 2 years ago
libmosquittopp.pc.in 97bfa506db Add pkg-config files to CMake build (#213) 2 years ago
mosquitto.conf dec769ce33 Client and doc ALPN additions 3 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. 11 months ago
readme.md ec3fd361be https links where possible. 3 months ago
set-version.sh 56757df512 Bump version and changelog details. 3 months ago
travis-configure.sh 9200a8e98b Better attempt at fixing mac travis. 10 months ago
travis-install.sh 1d3949bce0 Improve broker generated client ids for the non-Linux case. 7 months 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 https://test.mosquitto.org/

Installing

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

Building from source

To build from source the recommended route for end users is to download the archive from https://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
  • 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)