eclipse-mosquitto /mosquitto
Eclipse Mosquitto - An open source MQTT broker
★ 11,460⑂ 2,668👁 271⑃ 873● 2,922▤ 0
11,460
stars
2,668
forks
271
watchers
873
prs
2,922
issues
0
releases
README
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,
the mosquitto_pub mosquitto_rr, and mosquitto_sub utilities for
publishing and subscribing, and the mosquitto_ctrl, mosquitto_signal, and
mosquitto_passwd applications for helping administer the broker.
Links
See the following links for more information on MQTT:
- Community page:
- MQTT v3.1.1 standard:
- MQTT v5.0 standard:
Mosquitto project information is available at the following locations:
- Main homepage:
- Find existing bugs or submit a new bug:
- Source code repository:
There is also a public test server available at
Installing
See 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 very 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'
Note that starting the broker like this allows anonymous/unauthenticated access
but only from the local computer, so it's only really useful for initial testing.
If you want to have clients from another computer connect, you will need to
provide a configuration file. If you have installed from a binary package, you
will probably already have a configuration file at somewhere like
/etc/mosquitto/mosquitto.conf. If you've compiled from source, you can write
your config file then run as mosquitto -c /path/to/mosquitto.conf.
To start your config file you define a listener and you will need to think
about what authentication you require. It is not advised to run your broker
with anonymous access when it is publicly available.
For details on how to do this, look at the
authentication methods
available and the dynamic security plugin.
Documentation
Documentation for the broker, clients and client library API can be found in
the man pages, which are available online at . 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
Building from source
To build from source the recommended route for end users is to download the
archive from .
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
cJSON - required
c-ares (libc-ares-dev on Debian based systems) - optional, enable with
WITH_SRV=yes
libedit - for mosquitto_cTop issues
#1225Timestamps for retained messages64 comments · 2019-04-10#2887messages are no longer retained with 2.0.16+ (with a lot of reained topics?)60 comments · 2023-08-31#13341.6 bridge won't reconnect on bridge connection loss37 comments · 2019-07-09#1078Docker Error: Unable to open log file /mqtt/logs/mosquitto.log for writing.36 comments · 2018-12-13#2074Mosquitto unable to start32 comments · 2021-02-04#439The Mosquitto Broker Service on local computer started and then stopped ,Some services stop automatically if there are not in use by other services or programs31 comments · 2017-05-06#1270healthcheck30 comments · 2019-05-09#2890Unable to maintain passwords with mosquitto_passwd: Warning: File has world readable permissions. Future versions will refuse to load this file.Killed26 comments · 2023-09-08