Introduction
I want to start off by expressing my deep appreciation for the contributors to this thread, especially @claessens, whose detailed post provided a foundational guide for my setup. While their guide was immensely useful, some things have changed over the past year—likely due to updates in both Shelly and Home Assistant. Hence, I’ve documented the process that worked for me, hoping to help others navigate the updated setup landscape.
Environment
- Home Assistant Version: 2023.10.3
- Shelly Plus H&T Firmware: 20230912-081941/1.0.3-g6176478
- Hardware: gen2 (SNSN-0013A)
Steps to Follow
- Integrate Shelly in Your Network with Shelly App: Initiate by connecting your Shelly H&T Plus to the same network as your Home Assistant. This can be done during the initial onboarding via Bluetooth through the Shelly app.
- Find Outbound Websocket Settings: Navigate to Settings > Networks > Outbound Websocket in either the Shelly app or the Shelly Cloud.
- Enable Outbound Websocket / “SSL Connectivity”: The straightforward option to enable the websocket was missing in my case. I had to enable an “SSL connectivity” switch and chose “*” from the dropdown menu. Some have opted for a pem file, but this setting worked for me.
-
Enter WebSocket URL: Next, enter your WebSocket URL. For me, it was
ws://192.168.1.157:8123/api/shelly/ws
. Hit “Save” afterward. - Wake Up Device: Press the small black button on the back of your Shelly H&T Plus device, next to the batteries. Wait a moment, then press it again.
- Trigger Device Reboot: Navigate back to the Shelly app or Shelly Cloud to initiate a device reboot. Wake up the device again using the small black button.
- Check WebSocket Connection: At this point, the connection should be established. If it’s not, troubleshoot and resolve the issue before proceeding to the next steps.
- Update Home Assistant: Remove any previous integrations of Shelly H&T Plus with Home Assistant if they exist.
- Final Steps: Wait for Home Assistant to detect your Shelly H&T Plus and add it as a new integration. I had to reboot Home Assistant to make the new device visible. Be patient, as it took several minutes for the entity and sensors to appear in Home Assistant.