How do I compile mqtt_cpp with TLS support?

Add -DMQTT_USE_TLS to your compiler flags and link against -lssl -lcrypto libraries. The README provides example code for TLS client and server implementations to guide you.

What's the difference between mqtt_cpp and async_mqtt?

mqtt_cpp is in maintenance mode with only bug fixes, while async_mqtt is the new project for feature development. Use async_mqtt for new features or mqtt_cpp for stable, existing MQTT functionality.

Does mqtt_cpp work with C++17 or newer standards?

It requires C++14 as a minimum; compatibility with newer standards like C++17 or C++20 isn't guaranteed and may need testing, especially with std::variant usage if MQTT_STD_VARIANT is defined.

How to enable logging in mqtt_cpp?

Compile with -DMQTT_USE_LOG and link Boost.Log libraries. The README includes mqtt/setup_log.hpp for typical logging setup, but it adds dependency overhead.

Is mqtt_cpp good for building a production MQTT broker?

No, the broker feature is experimental and unstable; for production brokers, consider dedicated software or use mqtt_cpp only for prototyping or client/server roles.

What are the minimum dependencies for mqtt_cpp?

Core dependencies are C++14 and Boost 1.74.0 or later. Optional features like TLS or WebSocket require OpenSSL or Boost.Asio with WebSocket support, adding to the footprint.

mqtt_cpp — Header-Only MQTT C++ Library

What is mqtt_cpp?

mqtt_cpp is a header-only MQTT client and server library for C++14, built on Boost.Asio. It enables developers to implement MQTT protocol communication in their C++ applications, supporting both client and server roles with features like MQTT v5, TLS, and WebSocket. The library solves the need for a lightweight, high-performance MQTT solution in C++ without external dependencies beyond Boost.

Target Audience

C++ developers working on IoT applications, embedded systems, or network services that require MQTT messaging capabilities, particularly those already using Boost libraries.

Value Proposition

Developers choose mqtt_cpp for its header-only design, which simplifies integration, and its robust support for MQTT v5 and asynchronous I/O via Boost.Asio, offering a flexible and efficient alternative to heavier MQTT implementations.

Overview

mqtt_cpp is a C++ library that provides both MQTT client and server functionality, enabling developers to implement MQTT communication in their applications. It is designed as a header-only library, simplifying integration into C++ projects that require IoT messaging or broker capabilities.

Key Features

Header-Only Library — Easy integration without separate compilation; just include the headers.
MQTT v5 Support — Full compatibility with the latest MQTT protocol version for enhanced features.
Boost.Asio Based — Leverages asynchronous I/O for high-performance network operations.
TLS and WebSocket Support — Optional secure communication and WebSocket transport layers.
Client and Server Modes — Can act as both an MQTT client and server within the same codebase.
Experimental Broker — Includes experimental broker functionality for building custom MQTT brokers.

Philosophy

mqtt_cpp emphasizes simplicity and performance through a header-only design and reliance on established libraries like Boost.Asio, making it a robust choice for C++ developers needing MQTT capabilities.

mqtt_cpp

What is mqtt_cpp?

Overview

Key Features

Philosophy

Related Projects

Found a gem we're missing?

Use Cases

Best For

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions