5487395fb6
* Adding Dockerfiles to build versioned Docker images Dockerfiles have been added to create Docker images for Mosquitto v1.4.4 and v1.4.8 using Alpine Linux as a base. Different directories have been added for each version to decouple the configuration and entrypoint scripts. Currently they contain the same content, but this could change in the future. Docker Hub will also need to pull from specific directories when official docker images will be built and hosted on Docker Hub. * Removing unnecessary default config and volumes Mount points are created in the image, but volumes are not automatically created. The user can still create volumes for these mount points, but is not required to. The default configuration file is now copied from /etc/mosquitto/mosquitto.conf to /mosquitto/config/mosquitto.conf. The user can override this file by mounting a local configuration file to /mosquitto/config. Signed-off-by: David Audet <david.audet@ca.com> |
||
---|---|---|
client | ||
doc/historical | ||
docker | ||
examples | ||
installer | ||
lib | ||
logo | ||
man | ||
misc/currentcost | ||
security | ||
service | ||
src | ||
test | ||
.gitignore | ||
.travis.yml | ||
about.html | ||
aclfile.example | ||
appveyor.yml | ||
ChangeLog.txt | ||
CMakeLists.txt | ||
compiling.txt | ||
config.h | ||
config.mk | ||
CONTRIBUTING.md | ||
edl-v10 | ||
epl-v10 | ||
LICENSE.txt | ||
Makefile | ||
mosquitto.conf | ||
Mosquitto.podspec | ||
notice.html | ||
pskfile.example | ||
pwfile.example | ||
readme-windows.txt | ||
readme.md | ||
set-version.sh | ||
THANKS.txt | ||
travis-configure.sh | ||
travis-install.sh |
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:
- Community page: http://mqtt.org/
- MQTT v3.1.1 standard: http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/mqtt-v3.1.1.html
Mosquitto project information is available at the following locations:
- Main homepage: http://mosquitto.org/
- Find existing bugs or submit a new bug: https://github.com/eclipse/mosquitto/issues
- Source code repository: https://github.com/eclipse/mosquitto
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-ares2-dev on Debian based systems) - disable with
make WITH_DNS_SRV=no
- libuuid (uuid-dev) - disable with
make WITH_UUID=no
- libwebsockets (libwebsockets-dev) - enable with
make WITH_LIBWEBSOCKETS=yes
- openssl (libssl-dev on Debian based systems) - disable with
make WITH_TLS=no
Credits
Mosquitto was written by Roger Light roger@atchoo.org