HOUSECONTROL / THE DIY LIBRARY

Connect an Existing Shelly Wi-Fi Device to Home Assistant

Add an existing Shelly Wi-Fi device through Home Assistant's built-in integration, check local control and distinguish Wi-Fi models from BLU and Z-Wave products.

Gunay 2 min read Integration: Shelly
Connect an Existing Shelly Wi-Fi Device to Home Assistant

Already have a Shelly device installed and working? This walkthrough covers the software connection to Home Assistant—not electrical installation, enclosure access or rewiring. Leave fixed wiring and switchboard work to an appropriately qualified electrician.

Guide status: documentation-based, reviewed 6 November 2026. It is not a report of HouseControl testing every model. You can follow it on your own Home Assistant installation without buying a HouseControl plan.

Identify the Shelly family

Supported Shelly Wi-Fi devices communicate locally without the Shelly cloud. Check the exact family and firmware: most BLU sensors use BTHome, while Z-Wave models use a different integration.[7]

For this guide, use an already-working, mains-powered Gen2-or-newer Wi-Fi device. These normally need no extra push-update configuration; battery models and Gen1 need separate checks.[7]

Record the exact product name, generation, firmware and local IP address. Do not buy a model solely because its brand appears in our enquiry form.

Connect through the built-in integration

  1. Open Settings → Devices & services in Home Assistant.
  2. Configure a discovered Shelly device, or choose Add integration, search for Shelly, and follow the on-screen steps.[10]
  3. Supply the device’s hostname or IP address if requested. The integration’s host setting is the address of the Shelly device, not your Home Assistant server.[7]
  4. Complete any authentication prompts within your own Home Assistant interface, then inspect the discovered device and available entities.[10]

Verify one safe function

Choose a harmless test that suits the already-installed device—for example, observing a sensor or switching an ordinary lamp. Do not test on heaters, pumps, garage mechanisms or equipment where unexpected operation could cause harm.

Our suggested checklist:

  • Confirm the reported state matches the physical device.
  • Use one normal control, if appropriate, and confirm its result.
  • Check the state updates again after operating the existing physical control.
  • Leave the manufacturer’s normal controls available as a fallback.

If discovery or updates fail

Gen1 CoIoT and Gen2+ battery-device WebSocket configuration are separate cases. Check the official model/firmware limitations before changing networking.[7]

Do not expose the device or Home Assistant directly to the internet. If setup needs network segmentation or security changes, stop and get help rather than guessing.

Sources

[7] Official Home Assistant Shelly documentation source

[10] Official Home Assistant integration setup instructions

DIY WHEN YOU WANT. HELP WHEN YOU NEED.

Keep doing it yourself—or hand over the difficult part

We can help integrate your device and configure the automation remotely where your equipment and connection allow it.

  1. 01
    Tell us about your setup

    Share device model and the outcome you want—not passwords or access keys.

  2. 02
    Agree the scope and cost

    We check compatibility and explain any charges or applicable plan allowance.

  3. 03
    Approve a temporary session or arrange a callout

    We can arrange to connect remotely to your HouseControl device or visit and install it for you.

Intrigued by having a Smart Home?

If you’re not using HouseControl yet, send us an installation enquiry to see how we can set you up with smart-home automations.

Installation enquiry

SMS single text: 0/160 GSM-7 septets

Your message is only added to the channel you choose. Nothing is sent until you review and press Send in that app.