From bba38fda575df2c2fc8a13a63ebcec44014501dc Mon Sep 17 00:00:00 2001
From: Erik Montnemery <erik@montnemery.com>
Date: Wed, 24 Jun 2020 18:52:00 +0200
Subject: [PATCH] Warn against using the RabbitMQ MQTT Plugin (#13837)

---
 source/_docs/mqtt/broker.markdown | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/source/_docs/mqtt/broker.markdown b/source/_docs/mqtt/broker.markdown
index 535f4539649..608b7554a78 100644
--- a/source/_docs/mqtt/broker.markdown
+++ b/source/_docs/mqtt/broker.markdown
@@ -12,6 +12,14 @@ This is the most private option, is running your own MQTT broker.
 
 The recommended setup method is to use the [Mosquitto MQTT broker add-on](https://github.com/home-assistant/hassio-addons/blob/master/mosquitto/DOCS.md).
 
+</div>
+
+<div class='note warning'>
+
+There is [an issue](https://github.com/rabbitmq/rabbitmq-mqtt/issues/154) with the RabbitMQ MQTT Plugin which break MQTT message retention. Don't use the RabbitMQ MQTT plugin, instead use another broker like Mosquitto.
+
+</div>
+
 ## Configuration
 
 ```yaml