# MQTT Setup Instructions - For a Beginner, Start to Finish Example / Instructions **URL:** \ **Category:** Questions & Help\ **Created:** [September 22, 2024, 4:56pm UTC](https://community.homey.app/t/mqtt-setup-instructions-for-a-beginner-start-to-finish-example-instructions/116539 "2024-09-22T16:56:31Z")\ **Posts on this page:** 7\ **Page:** 1
**Author:** ![Dan\_Melideo](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/dan_melideo/32/58183_2.png) [@Dan\_Melideo](https://community.homey.app/u/Dan_Melideo)\ **Post date:** [September 22, 2024, 4:56pm UTC](https://community.homey.app/t/mqtt-setup-instructions-for-a-beginner-start-to-finish-example-instructions/116539/1 "2024-09-22T16:56:31Z")
Hello, I am looking for simple and clear instructions for implementing MQTT within Homey Pro and possibly utilizing it as well to import device information from Home Assistant. I have read a number of postings and its has become a bit confusing since many are specific trouble shooting posts followed with a string of procedural corrections. Additionally, there are four MQTT modules available within Homey: MQTT Broker, MQTT Client, MQTT Hub, and MQTT Server. Possibly two of these modules may be very similar or overlap each other. Can anyone provide a simple but with clear details/examples on how to setup and implement MQTT from start to finish? Or possibly point me to links which may in the order of implementation? Appreciate your help and support. ---
**Author:** ![PeterHa](https://avatars.discourse-cdn.com/v4/letter/p/94ad74/32.png) [@PeterHa](https://community.homey.app/u/PeterHa)\ **Post date:** [September 22, 2024, 8:04pm UTC](https://community.homey.app/t/mqtt-setup-instructions-for-a-beginner-start-to-finish-example-instructions/116539/2 "2024-09-22T20:04:50Z")
I’m not a DEV, only a normal user, and was able to setup HA → Homey and Homey → HA with these tutorials and instuchtions in a short time. I don’t want to claim that I understand everything, but it works 🙂 > [@\[TUTORIAL\]\[PRO\] How to integrate Home Assistant with Homey Pro and v.v](https://community.homey.app/t/tutorial-pro-how-to-integrate-home-assistant-with-homey/92641): > > → Nederlandstalige versie → [klik hier](https://community.homey.app/t/tutorial-pro-home-assistant-integreren-met-homey/77587) → Tutorial with examples of setting up HA from scratch, extended with zwave as example → [click me](https://community.homey.app/t/honeywell-t6-pro-zwave-help/114693/5) It is not very easy to connect Home Assistant (or HA) with Homey Pro when you are new to it, hence this comprehensive guide. You can make it work! (At least I hope so grin ) When I forgot something, or something is wrong: feel free to point it out. By default, all Homey devices are available @ HA after a successful connection using MQTT; BUT you ne… and > [@\[APP\]\[Pro\] Home Assistant - Community App](https://community.homey.app/t/app-pro-home-assistant-community-app/71477): > > Home Assistant - Community App [[large]](https://homey.app/a/io.home-assistant.community/) Happy with this app? Thank you for supporting community app development with a small donation via PayPal (send to friends). [[btn\_donate\_LG1] ](https://paypal.me/winklerronny) This Homey app adds support for many devices, scripts & scenes of your Home Assistant installation. Currently the following device types are supported: Switches Buttons Lights Sensors and Binary Sensors Media Players Climate Presence Scenes Scripts Compound (combined & customizable devi… If you have a specific problem during setup, then you should ask your question in one of the corresponding threads ---
**Author:** ![Peter\_Kawa](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/peter_kawa/32/173848_2.png) [@Peter\_Kawa](https://community.homey.app/u/Peter_Kawa)\ **Post date:** [September 22, 2024, 8:30pm UTC](https://community.homey.app/t/mqtt-setup-instructions-for-a-beginner-start-to-finish-example-instructions/116539/3 "2024-09-22T20:30:14Z")
> [@Dan\_Melideo](#): > > there are four MQTT modules available within Homey: MQTT Broker, MQTT Client, MQTT Hub, and MQTT Server Many apps have similar working apps in the app store. But to explain the MQTT jungle: MQTT Server = recently published by Emile (Athom); it’s sort of a hub + client + broker in one package. Originally these 3 apps were necessary to publish Homey devices, and to receive topic messages, these are still my preferred tools. MQTT Broker = you need one broker in your setup, it can run on Homey, or on HA, or elsewhere. MQTT Client = connects to a broker, and is needed to send / receive topic messages MQTT Hub = a tool which publishes preferred Homey devices to MQTT, it uses the MQTT Client app to communicate. It has lots of built-in tools You can run MQTT Hub & -Client on multiple Homey’s ---
**Author:** ![Dan\_Melideo](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/dan_melideo/32/58183_2.png) [@Dan\_Melideo](https://community.homey.app/u/Dan_Melideo)\ **Post date:** [September 23, 2024, 11:12pm UTC](https://community.homey.app/t/mqtt-setup-instructions-for-a-beginner-start-to-finish-example-instructions/116539/4 "2024-09-23T23:12:26Z")
Thank you Warmduscher. I have previously read these threads and as I researched, got confused. Will need to try again. ---
**Author:** ![Dan\_Melideo](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/dan_melideo/32/58183_2.png) [@Dan\_Melideo](https://community.homey.app/u/Dan_Melideo)\ **Post date:** [September 23, 2024, 11:30pm UTC](https://community.homey.app/t/mqtt-setup-instructions-for-a-beginner-start-to-finish-example-instructions/116539/5 "2024-09-23T23:30:48Z")
Thank you, Peter. Sounds like two paths: 1. Use MQTT Server as-is since its somewhat an aggregate of Broker, Client and Hub. Maybe least flexible but also easiest to configure. 2. Use the MQTT Broker, Client and Hub with setup in that order. Also use only one Broker across multiple platforms (HA or Homey) using Client and Hub. on/with each. I am assuming this may be the most flexible but challenging setup/configuration. I may try Using MQTT Server first to see if I can get a successful result. ---
**Author:** ![RonnyW](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/ronnyw/32/10879_2.png) [@RonnyW](https://community.homey.app/u/RonnyW)\ **Post date:** [September 24, 2024, 12:07pm UTC](https://community.homey.app/t/mqtt-setup-instructions-for-a-beginner-start-to-finish-example-instructions/116539/6 "2024-09-24T12:07:06Z")
The MqttServer has no option for HomeAssistant auto discovery. This way you have to create Mqtt entities manually in HA. MqttHub exports devices with HA auto discovery This way, you only have to add the MqttClient integration to HA and connect to your broker. Devices exported to Mqtt will automatically appear in HA as entities. ---
**Author:** ![Dan\_Melideo](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/dan_melideo/32/58183_2.png) [@Dan\_Melideo](https://community.homey.app/u/Dan_Melideo)\ **Post date:** [September 27, 2024, 12:09am UTC](https://community.homey.app/t/mqtt-setup-instructions-for-a-beginner-start-to-finish-example-instructions/116539/7 "2024-09-27T00:09:55Z")
Thank you. I hope to get back to this endeavor in the next few days. I did some additional reading but no real attempts at configurations. Getting an error with Homey " Retrieving broker data failed, Error: ENOENT … An obvious configuration error. Based on your response I should restart with MQTT (mosquito) on HA and then use Homey Mqtt Hub. Appreciate the feedback.