Installing Zigbee2MQTT with Home Assistant

Рет қаралды 123,055

Күн бұрын

I show you what Zigbee2MQTT is, why I use it and how you can install it with Home Assistant.
❤️ Found this video useful and want to support the channel? I'd love a donation at paypal.me/homeautomationguy
This video covers:
00:00 - Intro
01:10 - What is Zigbee2MQTT?
03:04 - Installation Pre-Requisites
04:30 - Installing the Zigbee2MQTT Home Assistant Add-On
07:30 - Pairing Devices with Zigbee2MQTT
09:11 - Installing Zigbee2MQTT as a Docker Container with Docker Compose
Related Blog Post: www.homeautomationguy.io/yout...
Related KZfaq Videos:
What is Zigbee KZfaq Video - • What is Zigbee? - • What is Zigbee?
What is MQTT and how can you use it with Home Assistant? - • MQTT and Home Assistant
Zigbee2MQTT vs ZHA - • Zigbee2MQTT vs ZHA (Zi...
Installation Instructions:
Zigbee2MQTT as an Add-On: www.zigbee2mqtt.io/guide/inst...
Zigbee2MQTT as a Docker Container: www.zigbee2mqtt.io/guide/inst...
Finding location of USB Stick in Linux/Docker: www.homeautomationguy.io/dock...
Downloading Sample Zigbee2MQTT Configuration File: www.zigbee2mqtt.io/guide/inst...

Пікірлер: 147

@junkins 2 жыл бұрын

Thank you so much! It's like you literally read my mind. Earlier today I was looking for a good video explaining how to do this. :)

@HomeAutomationGuy 2 жыл бұрын

Glad I was able to help!

@theowlpo Жыл бұрын

Great video and clear as always. Thank you for helping a newbie 🙂

@ThomasS17 5 ай бұрын

I have spent two day trying to install Mosquitto and Z2M in docker (I could have installed them in HA, but I wanted them to run separately), following multiple videos and written guides. Your video on how to install mosquitto in docker and this video finally helped me get it to run. Thank you! Also, one little note for anyone having issues accessing the web ui: don't forget to add 'frontend: true' to the configuration.yaml.

@HomeAutomationGuy 5 ай бұрын

I'm glad it was helpful! ☺️

@MyHeap 2 жыл бұрын

Thanks for the great video series. i had issues with loading the zigbee2mqtt front end on the docker version. I had to add frontend: true to the configuration file and restart zigbee2mqtt to fix it. Just thought I would share in case anyone else had a problem. Thank you for the video series. They really help this newbie out! Joe

@HomeAutomationGuy 2 жыл бұрын

Thanks for sharing!

@lakisan Жыл бұрын

Thank you so much.

@lacot5 Жыл бұрын

Same for me, took me a while to troubleshoot it

@nagisupercell Жыл бұрын

Same for me, I got it from Github discussion.

@theowlpo Жыл бұрын

Hi. I had the same problem. Thank you for sharing

@AdrianRMOS Жыл бұрын

Great tutorial. Thanks! Two things that would improve the video: 1) add a tip at 5:18 to do a hard refresh of the browser (Ctrl+F5). Sometimes Zigbee2MQTT addons don't show up after adding the repo. 2) add a tip at 7:13 to include "adapter: ezsp" in the configuration for Sonoff Zigbee Dongle-E.

@HomeAutomationGuy Жыл бұрын

Great tip!

@vintier2k 8 ай бұрын

awesome after like ten hours of searching through trash tutorials i found your video and it worked. thank you!

@HomeAutomationGuy 8 ай бұрын

Glad it helped

@vintier2k 8 ай бұрын

@@HomeAutomationGuy Now using it for a second time after destroying my machine and can confirm, tutorial is still useful LOL fk ubuntu

@taronk.4030 Жыл бұрын

Thanks! Everything works great!

@trevsweb 6 ай бұрын

just had my HA die and google deleted my backup so your video helped me out bigtime

@SergioBlackDolphin 3 ай бұрын

Thank you! You convinced me to go for ZHA! :-)

@HomeAutomationGuy 3 ай бұрын

It's great, and getting better each month!

@Dasol0135 5 ай бұрын

Great Video, Thanks for sharing.

@t3chrs 2 жыл бұрын

Thanks for the video. I’d love to see something similar for running ESPHome using docker compose.

@HomeAutomationGuy 2 жыл бұрын

I haven't yet dipped my toe into the water of ESPHome yet, but once I do I'll definitely be videoing it!

@nikolas-cy Жыл бұрын

Thank you ! Very Helpful the only problem if someone has problem and not starting is to set in zigbee2mqtt configuration file serial: adapter: ezsp

@dhruv.pandey93 Жыл бұрын

I really love the docker part of all your videos!! Can you please create a video on how to setup DuckDNS and HTTPS on dockerized Home Assistant?

@iBoyLPs 5 ай бұрын

yes please!

@Skracken 8 ай бұрын

Top tip: If you like me are using a ConBee flavour adapter, you need to add "adapter: deconz" in the serial setting of the addon

@ShadyfoxUK 5 ай бұрын

Thanks, this solved the problem I had with the 502 Bad Gateway error 👍

@Skracken 5 ай бұрын

@@ShadyfoxUK Glad it was of help :)

@tacklealto88 Жыл бұрын

Thank you!

@drbyte2009 2 жыл бұрын

Thx again for the video Alan. I have it up an running on my old laptop! Can you please also do a video for Node-Red?

@fredericomachado4116 Жыл бұрын

I followed all the steps for the docker install and for some reason the zigbee2mqtt frontend would not start. Ended up adding the following line to the zigbee2mqtt configuration.yaml file: frontend: port: 8080 and it worked!

@alexchapman8330 Жыл бұрын

Came here after a while of looking a solution to this problem! Thanks! Worked for me!

@Teleport73 Жыл бұрын

I had the same issue. Thank you so much for that! Was also useful for changing the frontend to a different port, as mine clashed with TasmoAdmin, already on 8080.

@ahmedabdelsalam6508 Жыл бұрын

I had the same issue, thank you!!

@bernharddablander225 6 ай бұрын

Thanks for the hint, also solved the problem on my system.

@CHLEE-ou6ub 2 жыл бұрын

Great video, thanks Needed to add this to zigbee2mqtt's configuration frontend: true to get the HAOS side panel to function. Thanks again.

@hugoribeiro874 2 жыл бұрын

only managed to make it work after this! Thank you!

@nicolasrigaud1139 2 жыл бұрын

I have 502 bad gateway ans no error on log file. I have put frontend : true but thats te same. Any idea ?

@gavintheurquhart 2 жыл бұрын

Thank you for this. Had the same issue and was failing to figure it out until I read this.

@gavintheurquhart 2 жыл бұрын

@@nicolasrigaud1139 where in your configuration.yaml file did you put that? Maybe you already figured it out? I put it below homeassistant: true and lined up with it and it worked. Log file then showed (after restart of container) "Started frontend on port 0.0.0.0:8080"

@lee-he3ey Жыл бұрын

Thank you for this.. it also fixed my issue

@GlennPerdicaro Жыл бұрын

Thanks for the excellent video, I'm considering whether to take the sonoff or wait for the new sky connect, does sky connect have any more advantages compared to sonoff dungle usb?

@EvolverDX Жыл бұрын

[12:04] the wget command created an additional data folder under your chosen path "zigbee2mqtt\data\. The downloaded sample file is saved to ".\zigbee2mqtt\data\data\configuration.yaml". Was this meant to be or was it a mistake?

@iBoyLPs 5 ай бұрын

pretty sure a mistake

@user-tv1ru6oe7v 6 ай бұрын

Hello Alan, great video, very well structured and explained . I'm new to HA and docker but following your video/blog was very easy to install them. Now I have a challenge :) I'm trying to install them with ssl/tls. The big issue is zigbee2mqtt which connect to mqtt (and publish to the HA topics) but the UI is not started. I checked the documentation and change the configuration but not succeed. It is possible to have a look on this topic and maybe to publish an update of this (great) tutorial?

@linlu2773 Жыл бұрын

thanks! I add the following command to configuration.yaml inside zigbee2mqtt folder. Otherweise the zigbee2mqtt frondend won't load in home assistant. # Enable the Zigbee2MQTT frontend frontend: port: 8080

@andrewmcnulty0 Жыл бұрын

dam bro i was on this for about 7 hours... you fixed it

@anirangs 6 ай бұрын

Great video. Can you tell me how do I update Zigbee2MQT docker installation? Should i mention it to pull the stable image in my docker compose file? TIA

@serhioromano Жыл бұрын

How to install node red with all HA elements?

@mbp5863 Жыл бұрын

Thanks for the video, it helped me out a lot! I have a problem i don't know how to solve though. I connected 2 devices with the zigbee2mqtt, but there are no devices or entities shown in the mqtt broker. Do you know what's wrong?

@tomhueb793 Жыл бұрын

Did U find a solution?

@roygift Жыл бұрын

I installed HA on my Synology NAS (DS720+) using Docker (as VM version doesnt work) and I dont have the Addons link available under HA settings. What are my options?

@Mike28081991 2 жыл бұрын

Hey Alan, thank you for your Videos. I absolutely love them! I just have to add one note for the installation method via docker-compose: I think there is a mistake when creating the configuration.yaml file. It is created in the wrong folder. If I follow your instructions, the file is created in the /opt/zigbee2mqtt/data/data folder. When starting the container the file in this directory will be ignored and instead a configuration.yaml file will be created in the folder /opt/zigbee2mqtt/data which looks exactly like the sample file we created before. Unfortunately, you did not show the logs after starting the container. I think there would have been an error.

@mathieuhantz 2 жыл бұрын

Hey, I face the same issue. What seems to be the best solution for you? I think editing the docker-compose.yaml this way : - /opt/zigbee2mqtt:/app/data (instead of -/opt/zigbee2mqtt/data:/app/data) may be a good answer, but I'm kind of a newbie, so any advice is welcome...

@Mike28081991 2 жыл бұрын

@Mathieu Hantz Burnet Hey you are rigth. I think that would also do the trick. But with this method the files in the container would be on a different level as on the host and wich i wanted to avoid. That is why my prefered solution was to manually create the configuration.yaml file in the directory zigbee2mqtt/data with visual studio code (instead of using the wget command like alan). Another method would be to write the wget command in the folder /zigbee2mqtt instead of /zigbee2mqtt/data like alan in 12:02

@mathieuhantz 2 жыл бұрын

@@Mike28081991 I didn't even though about these solutions, thank you for your quick answer ! I will try the last solution! Once more, thank you for your time and answer !

@xoarex Жыл бұрын

Yes Don't create the "data" directory Just run the wget inside the "zigbee2mqtt" directory, it will create the files for you in the proper place

@_od_7825 2 жыл бұрын

I'm running HA on a virtual machine using Virtual Box. I've already got everything running through ZHA, but I've got some new devices that need Zigbee2MQTT to work with HA. Do I need to remove all of the ZHA devices to be able to do this or can both run at the same time? I've also got an issue that as soon as I start Zigbee2MQTT my CPU usage goes through the roof and the fan kicks in at full speed. I then get 502:bad gateway when I try to look in the WebUI, the log is blank. This is the same set of errors that I got the first time I tried to use MQTT and is what put me off, but I must just be doing something wrong so any help would be appreciated.

@michaeloren3358 4 ай бұрын

I had to add the following for my dongle to the configuration.yml serial: adapter: ezsp

@JordanRiser Жыл бұрын

Is it possible to disable an Aqara switch internal relay with just ZHA? I have seen it's possible with Z2M but I already have ZHA installed and wonder if there is a way to do this that I'm just not seeing.

@revealingfacts4all 7 ай бұрын

great video but what I am not understanding is in Zigbee2MQTT under each device, click on settings for that device, there is a category called Home Assistant with an input field called Home Assistant Name. Inside MQTT Broker, I see devices showing up under zigbee2mqtt topic and a topic named homeassistant. So which is it? Additionally, I notice that the zigbee2mqtt friendly name shows up under the zigbee2mqtt topic while the IEEE ID shows up under homeassistant topic.

@guillaumebertin682 2 жыл бұрын

Hello, thanks for your video ! Do you know if the conbee 2 on a raspberry Pi4 with home assistant detected a roller shutter zigbee module that is installed behind a switch ? Thanks

@HomeAutomationGuy 2 жыл бұрын

That will depend on which roller shutter module you are using. ZHA supports quite a few different ones.

@antoniodecrisci2369 2 жыл бұрын

thanks for the video! Do I have to remove ZHA before adding Z2M?

@AshleyTayles 2 жыл бұрын

Yes you do, unless you have two zigbee coordinators.

@nicolasrigaud1139 2 жыл бұрын

How to do this ?

@jeanbernier6751 10 ай бұрын

Great video again. I got the container running fine, but the frontend panel does not want to connect to my server address. I can’t figure out what could be wrong.

@Assichick1 9 ай бұрын

have you figured it out?

@bat3332 2 жыл бұрын

Hey Can I ask you a simple question as someone who is going to begin home automation from first step. Should I buy a raspberry pi or nuc with windows. For home assistant I know nuc are on the pricier side but ignoring the pricing factor in the long run. Which one should I consider Nuc(windows) or Raspberry pi. for additional info I dont have either one or used either one before

@HomeAutomationGuy 2 жыл бұрын

Get a raspberry pi. It's cheaper and easier to get started. If you get really into it you can always upgrade to something more powerful (and expensive) in a year or so. Raspberry pi is a FANTASTIC place to start with Home Assistant and home automation Good luck and have fun with it! ☺️

@bat3332 2 жыл бұрын

@@HomeAutomationGuy Thank you so much for the information . Once I purchase it I will have more question untill then please keep inspiring us

@janosch123456789able Жыл бұрын

Guys one question, i have openmediavault 5 and use portainer. So far did nothing in terms of home assistant, but I want to get startet. So my question is can I install ha on docker using portainer and than setup all the other stuff concerning ZigBee as described in this video? I am not an expert so I want to keep it simple. Thanks for all kinds of advice!

@HomeAutomationGuy Жыл бұрын

I am pretty sure you can, but I've not personally tried it

@dinadenic2756 11 ай бұрын

Maybe someone can help me here. When I use the ls -l /dev/serial/by-id I get the following message: "No such file or directory". I'm running HA on a docker container. Thanks!

@raveen69 2 жыл бұрын

But sure if this was asked, but why should I use the mqtt version vs just the native ZHA? What makes the mqtt version "better"?

@HomeAutomationGuy 2 жыл бұрын

I cover that in this video actually: kzfaq.info/get/bejne/aq13Z8ZyssrYgX0.html

@bobbymooreok Жыл бұрын

any way to encrypt or hide your MQTT password? Or can we just copy the hash from previous video?

@keroner9998 Жыл бұрын

Maybe someone can help me here. I cant get zigbee2mqtt working. When I use the ls -l /dev/serial/by-id I get the following message: "No such file or directory" I'm running HASS in VMware and the host machine is Windows 11. Thanks in advance!!

@robobobo23 5 ай бұрын

not big deal to set it up.. i have the same scenario at home.. but im wondering how we can access these panel menu from outside (from HA application).. i tried to expose it to world through the ngninx and it worked.. but its not so good idea as there's no password protection so eveybody with the link could manage my home :) any idea ?

@SondelaConsulting Жыл бұрын

What adapter do you recommend from the list for an absolute beginner like me

@HomeAutomationGuy Жыл бұрын

Either the Sonoff 3.0 USB Dongle Plus or the Home Assistant SkyConnect

@SondelaConsulting Жыл бұрын

@@HomeAutomationGuy thanks

@lowrider692000 7 ай бұрын

got a notification that says you uploaded this 2 mins ago here it says 1 year lost now as a year in Tech may as well be 10 years lol

@HomeAutomationGuy 7 ай бұрын

Well that's odd, I definitely uploaded it years ago! Silly KZfaq!

@Calzune 2 жыл бұрын

I have followed all your steps but I get 502 bad gateway... HELP!

@diogor420 2 жыл бұрын

Would I get access to addons if I installed home assistant in an Intel Nuc with Proxmox?

@HomeAutomationGuy 2 жыл бұрын

Yes, if you install the Home Assistant OS version

@rakeshkumart9297 7 ай бұрын

How to install Home Assistant on windows 11, I have a Sonff ZigBee dongle plus, i need to pair that with ZigBee enabled sensor(Temperature and Humidity sensor).

@HomeAutomationGuy 7 ай бұрын

You will need to install it in a virtual machine.

@FedeHippo 2 жыл бұрын

I currently have 108 devices and 505 entities connected via ZHA, using the same SOnOff dongle as you do in the video. Would there be any advantages for me by goind through the hassle of moving everything to Zigbee2MQTT ?

@HomeAutomationGuy 2 жыл бұрын

Nope! I'd stay using ZHA if I was in your situation. If it ain't broke, don't fix it!

@discodogge 2 жыл бұрын

@@HomeAutomationGuy how many devices do you have in your network? And would you say it's been stable? Considering moving my 140 devices from deconz to gain better device capabilities and faster implementation of new devices.

@TheBurnsiela 2 жыл бұрын

I have around 70-80

@TheBurnsiela 2 жыл бұрын

And yes. It's been pretty stable. I've had the odd blip when someone has unplugged or switched off a router device in the middle and I've had to repair devices. But that has only happened two or three times in three years

@discodogge 2 жыл бұрын

@@TheBurnsiela yeah, that sounds alright I would say :) thanks! It's hard to find any mentions of stability in larger networks :)

@Maaniic 2 жыл бұрын

You should probably recommend attaching the dongle on an USB extension as it can dramatically increase the range and/or reliability of the mesh(coordinator). As ZB is low power and on the heavily contested 2,4 GHz band, sitting close to the computer might disrupt it quite a lot. If you want you could also look up the frequency plans and see to it that you don't overlap with your wifi.

@HomeAutomationGuy 2 жыл бұрын

I do recommend a USB cable at 3:20.

@Maaniic 2 жыл бұрын

@@HomeAutomationGuy Ah must have looked away when watching that later part, my bad :)

@Maaniic 2 жыл бұрын

@@HomeAutomationGuy Personally I have experimented with attaching a dongle to a RaspiZero2 with Zigbee2Mqtt so that i can have multiple coordinators remotely to Hassio.

@robertperkins4909 Жыл бұрын

How to find Conbee II devname on VM Virtualbox to be able to configure Zigbee2MQTT on HA?

@HomeAutomationGuy Жыл бұрын

I don't know, I'm not an expert on VMs

@CCoburn3 2 жыл бұрын

Presumably, there is a similar plugin for z-wave.

@HomeAutomationGuy 2 жыл бұрын

I believe it's almost the same setup, but I've never personally used it so I'm not 100% sure

@Danish3Cubed 4 ай бұрын

You need to activate terminal, it's not on by default, I think that is worth mentioning.

@HomeAutomationGuy 4 ай бұрын

That's a good tip, thanks for sharing!

@grygub Жыл бұрын

Major miss in the configuration.yaml instructions. You must add frontend: true or there will be no dashboard to go to. Other than this I really appreciated this guide. I also second using serial by-id to specify the zigbee radio

@SkysimAir 8 ай бұрын

Thanks for pointing this out. I was already in desperation mode, because no frontend showed up, although there was no error message in the log.

@WvnDesign Жыл бұрын

I'm unable to find my usb any way possible it seems.. Give gives cant find it. Im on Synology + docker

@saarnevejans9623 Жыл бұрын

installed the usb driver ?

@chimpsinties 8 ай бұрын

At 12:04 you say to navigate to the new data folder you just created and then run the wget from their website. This is wrong. If you do that, it will create another folder inside your data folder also called data, but that means your configuration.yaml file will be in the wrong place (1 folder too deep). The wget will auto create the data folder if you run it from the zigbee2mqtt folder. You also need to have the frontend variable set in that configuration.yaml file or your trick to mount it as an inside HA doesn't work. Maybe things have changed since you did this guide but it just took me a long time to spot this after watching someone elses guide. so as the last 2 lines it should read frontend: port: 8080

@mako9673 Жыл бұрын

Man I have been racking my brain trying to figure out why Zigbee2MQTT will not work properly in my docker container. Followed this video twice, and checked online and tried a few ideas there. But still cannot get this thing to talk to my zigbee controller. The only thing I have not tried yet is reflashing the firmware on the controller. I may have to do that.

@benjenkins183 10 ай бұрын

Did you ever solve it? I'm having similar issue. sonoff dongle 3.0 plus-e

@mako9673 9 ай бұрын

@@benjenkins183 It took a lot of time, but finally got it working. There is a task that is was running at the same time, that is sort of hidden, that was conflicting. I am not at home or at my computer at the moment. But believe it was the built in MQTT sub task that you would run if you were installing it with out using docker containers. I thought it was part of the needed components, but it was not. Once I fully disabled, or uninstalled it (don't remember what exactly) it started working without any errors.

@haligali386 2 ай бұрын

how you add thsoe devices now as entity to home assistant?

@HomeAutomationGuy 2 ай бұрын

They get added automatically if you have the MQTT integration configured

@haligali386 2 ай бұрын

@@HomeAutomationGuy yea i did miss in the documentation the homeassistant: true nice video, thank you

@Skeeterflea 7 ай бұрын

My Zigbee2MQTT container is running but I cannot connect to the web interface on 8080. I have 'frontend: true' in my /opt/zigbee2mqtt/data/configuration.yaml file.

@HomeAutomationGuy 7 ай бұрын

Make sure you've got the ports mapped through and that the routing is working correctly.

@guyvxt 6 ай бұрын

I have the same issue. I've tried deleting the container etc still no joy... I have tried frontend:true and Frontend: port:8080 as suggested in the comments on here. Almost at the point of giving up...

@guyvxt 6 ай бұрын

finally sorted my issue. I checked the logs in the zigbee2mqtt data folder. The log file listed a load of errors with my USB device starting. It said to delete the coordinator_backup.json file so I did and restarted in portainer. Now working!

@AceBoy2099 9 ай бұрын

Heck, my program won't even start mostly 502 bad gateway.... "error: spawn udevadm EN0ENT" in log.

@kmtsvetanov 7 ай бұрын

same here. Any new info ?

@DanangWidiantoro Жыл бұрын

mine is 502: bad gateway i've been waiting for while

@wouter2599 Жыл бұрын

Did something happend to your blogpost. It seems rather empty with just some links to other sites instead of a step by step tutorial lika the other blogpost/videos

@HomeAutomationGuy Жыл бұрын

There are different steps based on your type of HA installation, which I why I've linked out to the official instructions (which are really good and detailed)

@iraabramowitz6027 2 жыл бұрын

I am getting an invalid repository error and cannot get further, Thanks

@iraabramowitz6027 2 жыл бұрын

I added the repository after rebooting the RPi several times and typing in the url directly

@gzcwnk 2 жыл бұрын

nope 502 error....:/

@rfehr613 Жыл бұрын

I cannot get z2m to start. I did exactly the steps in the beginning, but when i click Start it fails and says "error while starting zigbee-herdsman". I'm running a new installation of HAOS on bare metal and this is my first attempt at setting up a zigbee network. I already have mosquitto setup BTW.

@HomeAutomationGuy Жыл бұрын

Make sure your USB stick is mapped correctly

@rfehr613 Жыл бұрын

I'm not sure what you mean by mapped. The dongle had the right firmware and was visible on the usb port. After a bunch of searching I finally figured it out. I had to define inputs for 'mqtt' and 'serial' on the config page. In your video you just left both blank and it still started fine. So they must have changed something since making this video, because mine absolutely refused to start without these inputs.