Skip to content

michaelplaing/mosquitto

This branch is 251 commits behind eclipse-mosquitto/mosquitto:master.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

3cbe805 · Nov 17, 2021
Apr 3, 2021
Oct 6, 2021
Oct 27, 2021
Dec 4, 2020
Oct 13, 2020
Oct 5, 2021
Nov 17, 2021
Oct 5, 2021
Nov 17, 2021
Nov 17, 2021
Nov 17, 2021
Oct 5, 2016
Oct 5, 2021
Oct 5, 2021
Nov 6, 2021
Dec 27, 2020
Apr 26, 2021
Nov 17, 2021
Nov 9, 2021
Nov 16, 2021
Nov 17, 2021
Nov 17, 2020
Mar 27, 2020
Nov 17, 2021
Aug 1, 2019
Nov 17, 2021
Nov 25, 2020
Oct 5, 2021
May 13, 2021
Jun 9, 2021
Nov 5, 2020
Nov 12, 2020
Oct 5, 2021
Apr 6, 2021
May 29, 2019
Oct 5, 2021
Oct 5, 2021
May 7, 2014
Apr 12, 2018
Oct 5, 2021
Apr 18, 2021
Nov 17, 2021
Oct 5, 2021
Oct 5, 2021
Sep 10, 2016
Sep 10, 2016
Sep 9, 2021
May 7, 2014
May 7, 2014
Nov 17, 2021
Sep 25, 2018
Dec 4, 2020

Repository files navigation

Eclipse Mosquitto

Mosquitto is an open source implementation of a server for version 5.0, 3.1.1, and 3.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) - only when compiled with make WITH_SRV=yes
  • cJSON - for client JSON output support. Disable with make WITH_CJSON=no Auto detected with CMake.
  • libwebsockets (libwebsockets-dev) - enable with make WITH_WEBSOCKETS=yes
  • openssl (libssl-dev on Debian based systems) - disable with make WITH_TLS=no
  • pthreads - for client library thread support. This is required to support the mosquitto_loop_start() and mosquitto_loop_stop() functions. If compiled without pthread support, the library isn't guaranteed to be thread safe.
  • uthash / utlist - bundled versions of these headers are provided, disable their use with make WITH_BUNDLED_DEPS=no
  • xsltproc (xsltproc and docbook-xsl on Debian based systems) - only needed when building from git sources - disable with make WITH_DOCS=no

Equivalent options for enabling/disabling features are available when using the CMake build.

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)

About

Eclipse Mosquitto - An open source MQTT broker

Resources

License

Security policy

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C 64.6%
  • Python 28.3%
  • Makefile 2.5%
  • C++ 1.4%
  • Dockerfile 1.2%
  • CMake 0.8%
  • Other 1.2%