Version 8.0.0

Important note https://github.com/redboltz/mqtt_cpp/wiki/News.

MQTT v5 is supported since version 4.0.0.

mqtt_cpp is a header only library. It requires C++14 and the Boost Libraries 1.66.0 or later.

Add mqtt_cpp/include to your include path. Then, include mqtt_cpp.hpp and/or mqtt_server_cpp.hpp as follows:

For clients:

#include <mqtt_client_cpp.hpp>

For servers:

#include <mqtt_server_cpp.hpp>

You can compile your program as follows:

g++ -std=c++14 -Ipath_to_mqtt_cpp/include no_tls.cpp -lboost_system -lpthread

g++ -std=c++14 -Ipath_to_mqtt_cpp/include tls.cpp -lboost_system -lssl -lcrypto -lpthread

If you want to use MQTT on WebSocket, you need to define MQTT_USE_WS macro. mqtt_cpp uses https://github.com/boostorg/beast for WebSocket communication and it requires boost::string_view, so the boost library need to support boost::string_view.

• NO TLS
  • Client
    • TCP
      • example/no_tls_client.cpp
    • WebSocket
      • example/no_tls_ws_client.cpp
  • Server
    • TCP
      • example/no_tls_server.cpp
    • WebSocket
      • example/no_tls_ws_server.cpp
  • Client and Server
    • TCP
      • example/no_tls_both.cpp
    • WebSocket
      • example/no_tls_ws_both.cpp
• TLS
  • Client
    • TCP
      • example/tls_client.cpp
    • WebSocket
      • example/tls_ws_client.cpp
  • Server
    • TCP
      • example/tls_server.cpp
    • WebSocket
      • example/tls_ws_server.cpp
  • Client and Server
    • TCP
      • example/tls_both.cpp
    • WebSocket
      • example/tls_ws_both.cpp

You can build tests and examples as follows:

At mqtt_cpp directory

mkdir build
cd build
cmake ..
make
make test

In order to build tests, you need to prepare the Boost Libraries 1.59.0.

https://github.com/redboltz/mqtt_cpp/wiki

You can create html documents using doxygen.

make doxygen

mqtt_cpp is licensed under the Boost Software License, Version 1.0. See the LICENSE_1_0.txt file for details.