→ Tutorial with examples of setting up HA from scratch, extended with zwave as example → click me
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 )
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 need to install the desired HA devices on Homey, just like other devices need to be installed.
The ‘Devices’ tab allows you to exclude devices you don’t want in HA. Fewer devices benefit performance and crash sensitivity.
CAUTION to immediately remove devices you add to Homey using the Home Assistant Community app from the Devices list. To avoid loops! ((*) as long as new devices are still automatically added to the list)
Go to tab ‘Log’, and set the level to “Errors and Warnings”, to reduce log size and performance
Configuration:
On the mobile app, go to …More → Apps → MQTT Client → Configure app
Enter your data, like the example data in the settings screen screenshot, and save the settings
The username + password of the MQTT Client as well as the MQTT Broker must be the same
Click ‘Configure’ to enable MQTT detection if required, and click ‘Save’ in the screen that follows:
(Translated: Would you like to configure HomeAssistant to connect to the MQTT-Broker which is presented to you by the Mosquitto Broker add-on “Save”)
You can e.g. also use this trigger to automatically restart HA f.i.
HA offline or back online
If HA has been offline, or Homey, I always had to manually perform a ‘broadcast’ in the MQTT Hub app, otherwise the Homey devices on HA would no longer work. Also, a notification is sent.
And a totally ‘useless’ option: I also set an AVD’s (advanced virtual device) status to on/offline . It’s called “HA On-Offline”. Also a variable is updated with the status
- Run the following @ HA
Optional: install HACS store
Click here
HACS = Home Assistant Community Store There are many nice ‘apps’ in this additional store, but it is not supported by HA
Hey,
what could I be doing wrong?
It seems I set up everything according to the guide, but the MQTT in HA does not find the Homey devices.
The MQTT explorer:
Could be an account issue. Enter exactly the same credentials for the mqtt broker & -client
Does the mqtt-explorer homey entry, show ‘status=online’?
What does the mqtt client log show?
Same for the broker log
The Mosquitto Log looks exactly the same, I checked the username/password combination…
On Homey I got:
MQTT Client v3.0.0
Above the red line: to be sure I changed the password to something else and as expected authentification failed. I changed it back to the correct password, then the log below the red line was created.
MQTT Hub v3.6.1 (Test)
The logs are very quite…
No errors or something, it just states new devices I added yesterday.
On Home Assistant:
Mosquittos log as mentioned above looks the same as yours, where can I find the logs for the MQTT integration?
If I change the password it instantly fails, so it only continues if I use the correct password.
I didn’t find the second config screen in your guide so I didn’t change anything there:
.
About the logging:
When you open the MQTT integration, hit “ebable debug logging” (make sure to turn it off after a while, bcause it can have a negative impact @ HA performance)
Now after, say, 10 to 15 minutes, disable it again
Now go to Settings > System > Logs
Select “Home Assistant Core” at the top right.
Look for MQTT messages
Yes, I clicked that a few times while debugging, but it seems to have no effect at all.
In the Logfile it states “refresh”, but nothing else happens, there are no new messages or something else in the MQTT explorer, so I guess here lies the problem?
You mean the Screenshot under the section:
Right? Yes, I made sure everything looks the same and double checked it now.
Yes, if I change the credentials to something else it immediately fails with an error message that no connection could be estabilished.
within the MQTT Log (after disabling the debugging my browser just prompted me to download the .log file) I can not find anything useful. The only errors are when I tried to enter wrong credentials, otherwise its just full of status updates / payloads from my zigbee devices connected to the HA Pi, nothing about homey.
So, I think the error is on the homey side, especially with the MQTT Hub app. I did install the test-version by following your link, that was correct, right? Or should I switch to the older release version?
News…
I realised that the MQTT Hub switched the “Running” switch off, so I reenganged it. The logfiles only stated switch on and running but nothing else. After reloading the homey app the “Running” switch was off again.
I then had the Idea to exclude the devices which are connected to the HA Pi and brought to homey correctly (2 Motion sensors, 1 Bulb and a Dice). After excluding those devices the “Running” switch stays on and now when I press the Broadcast button the log even outputs new information!
so, yeah, the disabled devices are because I disabled them … but then it states Skip - invalid broadcast followed by HomieDecives initialized: false and MQTT Client registered: undefined?
Just to be sure, didn’t get a confirmation yet about
I meant the credentials you should have entered with the third place you’ll need to logon, MQTT integration as I showed right below my question.
Don’t know if it’s related to the MQTT Hub issues, but one can’t check too much.
Correct, I use that version as well.
I can’t see any issues
I didn’t encounter that behaviour, so
One idea, but a bit of last resort:
Remove the MQTT Hub app,
Reboot Homey,
and then install it again, and enter the custom communication protocol settings again…
So… the devices are synced to HA now.
No Idea why/ what happened, the only thing I did yesterday was deactivate the devices in MQTT Hub which are connected to HA.
Now, over night, everything seems to have sorted out?
The MQTT Explorer now shows 2414 topics, so very busy…
Thank you for your instructions above, which I followed and got the MQTT connection working fine.
Now I am working on some flows, and have a question in relation to the flow example you have posted. What is this “HA On-Offline”? Is a special app used to create this, or something else? And how do I replicate this?
This is an advanced virtual device by the Device Capabilities app.
It can, for instance, do almost anything with the status indicator.
Prior to Homey app v7.2.0 it could not display text as value.
With this device, it was and is possible.
First of all thank you a lot for these instructions… It really helped me to configure HA and Homey.
All is working well, but just want to give you a small feedback.
After the point that you can see in the image below (Discovered MQTT integration), I didn’t need to do any more steps… Like for example Reconfigure MQTT.
When I selected the discovered integration all was working and the devices being added from Homey in HA.
I bought the Homey Pro with insanely high expectations and sadly, it isn’t what all the “Social Media influencers” made it out to be. I since picked up a Home Assistant Blue and love it. I decided I wanted to at least integrate the paper weight, err, Homey Pro with the amazing Home Assistant Blue.
I followed your steps and it wasn’t working. It finally hit me, because I am using Starlink, ports are not open at all, which was causing the actual internal IP address to not be able to link up between the two devices/apps. So I changed all the Homey Pro side to my Tailscale VPN IP address and boom it all worked. Just wanted to put this here for others on ISP’s that block all ports.
Hmmmmm I don’t get why you complain about the wrong image you got from Homey at this users forum, Walter, we can’t help you man → I’d suggest to let Athom know what you miss, or what you like to see on a Homey, they don’t read your messages in here. Go to Support | Homey
Solved:
In the Broker i have tried to save password and user like the giude say but it will not save it also when i try to edit the YAML it don´t save it?
This way it works.
logins: [
{
“username”: “yourMQTT”,
“password”: “yourMQTTpass”
}
]
I was adding a new temp sensor and som other devices to the homey but it dont show up in Home Assistant?
What to do to get the new added devices in Homey over to Home Assistant?
Via MQTT Hub?
The devices are shown in MQTT Hub app settings. But it needs an app restart to do the initiaal device sync.
After restarting the MQTT Hub, new devices should appear in HA.