# ESP-MQTT

[中文]

## Overview

ESP-MQTT is an implementation of MQTT protocol client, which is a lightweight publish/subscribe messaging protocol. Now ESP-MQTT supports MQTT v5.0.

The ESP-IDF component `ESP-MQTT` has been moved from ESP-IDF since version v6.0 to a separate repository:

- esp-mqtt component on GitHub

To add ESP-MQTT component in your project, please run `idf.py add-dependency espressif/mqtt`.

## Hosted Documentation

The documentation can be found on the link below:

- esp-mqtt documentation

## Application Examples

Two reference examples are available in ESP-IDF:

- MQTT over TLS (certificate bundle): `examples/protocols/mqtt`

  - Validates the broker with ESP-IDF's certificate bundle (default).

  - Default broker URI targets `mqtts://test.mosquitto.org:8886` (Let's Encrypt chain).

  - Alternative configuration pins Mosquitto CA and uses `mqtts://test.mosquitto.org:8883`.

- MQTT 5.0 over TLS (certificate bundle): `examples/protocols/mqtt5`

  - Uses MQTT v5.0 with TLS and validation via the certificate bundle.

  - Default broker URI targets `mqtts://test.mosquitto.org:8886`.

For additional transport modes (TCP, WS/WSS, mutual auth, etc.), see the examples in the espressif/mqtt component repository.

Was this page helpful?

- Thank you! We received your feedback.
- If you have any comments, fill in Espressif Documentation Feedback Form.

- We value your feedback.
- Let us know how we can improve this page by filling in Espressif Documentation Feedback Form.