Articles

How to Set Up Shelly Devices in Home Assistant (Local, No Cloud)

On this page
    TL;DR: To set up Shelly devices in Home Assistant, connect the Shelly to your 2.4 GHz Wi-Fi through its own hotspot and web page, then add it under Settings > Devices & services, where it usually shows up as discovered. The Shelly integration talks to the device directly on your network, so you do not need Shelly Cloud. Gen1 devices (Shelly 1L, Shelly 2.5, Shelly Plug S) need one extra setting called CoIoT peer for instant updates.

    Updated November 2026 for Home Assistant 2026.10 and 2026.11. This page replaces our old Shelly Cloud app guide and also covers the Shelly 1L, Shelly 2.5 and Shelly Plug S.

    Shelly makes small Wi-Fi relays that fit behind a wall switch, plus smart plugs and sensors. A relay is an electric switch that a small circuit opens and closes. Shelly devices are a great fit for Home Assistant because they work fully locally. This guide shows how to set up Shelly devices in Home Assistant without the cloud, step by step, with notes for the Shelly 1L, the Shelly 2.5 and the Shelly Plug S.

    What you need

    • A running Home Assistant install
    • A Shelly device, for example a Shelly 1L, Shelly 2PM Gen3 (the newer version of the Shelly 2.5) or Shelly Plug S
    • A 2.4 GHz Wi-Fi network. Shelly devices do not connect to 5 GHz.
    • A phone or laptop to reach the device’s hotspot the first time
    • For wired models: an electrician, or solid experience with mains wiring
    What you needShelly 1PM Gen3 relayGoes behind your existing wall switch, keeps it working, local API and power metering.Check price on AliExpressShelly Pro 3EM / EM energy meterWhole-house energy monitoring with CT clamps, local, and made for the Energy dashboard.Check price on AliExpressZigbee smart plug with energy monitoringLocal Zigbee plug that reports watts and kWh, and doubles as a mesh repeater.Check price on AliExpress

    Shelly generations: Gen1 vs Gen2, Gen3 and Gen4

    Shelly has released four generations of devices, and the name tells you which one you have:

    • Gen1: the original line, like the Shelly 1, Shelly 1L, Shelly 2.5, Shelly Dimmer 2 and Shelly Plug S.
    • Gen2: the Plus and Pro models, like the Shelly Plus 1 or Shelly Plus 2PM. Pro models mount on a DIN rail in your electrical panel.
    • Gen3 and Gen4: names that end in Gen3 or Gen4, like the Shelly 1L Gen3 or Shelly 2PM Gen4. They add more memory and Bluetooth, and many also support Matter.

    Home Assistant’s Shelly integration supports all four generations. The difference for you is small: Gen1 devices send their updates with a protocol called CoIoT and need one extra setting (Step 3 below), while Gen2 and newer devices just work.

    The models people ask about most:

    Model Generation What it does Neutral wire Newer version
    Shelly 1L Gen1 1 channel light switch Not needed Shelly 1L Gen3
    Shelly 2.5 Gen1, discontinued 2 relays with power metering, or 1 roller shutter Needed Shelly Plus 2PM, 2PM Gen3, 2PM Gen4
    Shelly Plug S Gen1 Plug-in smart plug with power metering No wiring Shelly Plus Plug S, Plug S Gen3

    For a bigger overview of what each Shelly model is good for, see our Shelly products comparison table.

    AliExpress deals

    Local control vs Shelly Cloud

    Shelly Cloud is Shelly’s online service. It is what the Shelly Smart Control app uses to reach your devices from anywhere. Home Assistant does not need it. The Shelly integration talks straight to each device over your home network, which is called local control.

    Local is better for a few reasons:

    • It keeps working when the internet is down. Your lights still respond to Home Assistant and to the wall switch.
    • It is faster. A command goes from Home Assistant to the device in a fraction of a second, with no trip to a server.
    • It is more private. Your switching and power data stay in your home.

    You can leave Shelly Cloud switched on if you still want to use the app. It does not get in the way of Home Assistant. If you never use the app, switch Cloud off in the device’s settings. If you are still choosing between Wi-Fi, Zigbee and Matter devices, our guide to smart home connectivity options compares them.

    Safety first: wiring basics

    Most Shelly relays connect to mains voltage (110 to 240 V). That can kill you. Always switch off the circuit breaker before you open a switch box, and check with a voltage tester that the wires are dead. If you are not sure what live, neutral and load mean, or your local rules require it, let an electrician install the device. Plugs like the Shelly Plug S need no wiring at all.

    The terms you will see on a Shelly:

    • L (live): the wire that carries power.
    • N (neutral): the return wire. Many older switch boxes do not have one, which is why the Shelly 1L exists.
    • O (output): goes to your light or appliance. The Shelly 2.5 has two, O1 and O2.
    • SW (switch input): goes to your existing wall switch, so it keeps working.

    Always follow the wiring diagram in the manual for your exact model.

    Step 1: Connect the Shelly to Wi-Fi without the cloud

    1. Power on the device. A new Shelly starts its own Wi-Fi hotspot with a name that starts with shelly and ends in part of its ID.
    2. Connect your phone or laptop to that hotspot.
    3. Open a browser and go to http://192.168.33.1. This is the device’s own web page.
    4. Open the Wi-Fi settings (under Internet & Security on Gen1 devices), enter your 2.4 GHz network name and password and save.
    5. The Shelly joins your network. Find its new IP address in your router and give it a fixed address (a DHCP reservation), so Home Assistant always finds it at the same place.
    6. Open the device’s web page at its new address and install any firmware update it offers.

    Do not see the hotspot? Factory reset the device. On most relays you power it on and press the reset button (or flip the wall switch) several times within the first minute. The exact sequence is in the model’s manual. The Shelly Smart Control app can also add devices to Wi-Fi if you prefer an app, but it is not required.

    Step 2: Add the Shelly integration in Home Assistant

    1. Go to Settings > Devices & services.
    2. Shelly devices on your network usually appear at the top as Discovered. Click Add on the device.
    3. If it is not discovered, click Add integration, search for Shelly and enter the device’s IP address in Host. Leave Port alone unless the device sits behind a Shelly range extender.
    4. If you protected the device with a password, Home Assistant asks for it.
    5. Pick an area (a room) and finish.

    Home Assistant now creates the entities. An entity is one thing Home Assistant can see or control, like a switch, a power sensor or a firmware update. A relay shows up as a switch by default. If it controls a light, set its consumption or appliance type to “light” in the Shelly’s web page and it appears as a light entity instead.

    The official Shelly integration page lists every supported model and option.

    Step 3 (Gen1 only): Set the CoIoT peer

    Gen1 devices push their state changes with CoIoT. Without the right setting, Home Assistant may see wall switch presses late, and it shows a repair notice. To fix it:

    1. Open the Shelly’s web page.
    2. Go to Internet & Security > Advanced Developer Settings.
    3. Make sure Enable CoIoT is ticked.
    4. In CoIoT peer, enter your Home Assistant IP address followed by :5683, for example 192.168.1.10:5683, and click Save.
    5. Reboot the Shelly.

    This is required for battery Gen1 devices like the Shelly H&T and recommended for all the others.

    Notes for popular models

    Shelly 1L (no neutral)

    The Shelly 1L is made for switch boxes with only a live wire and no neutral. It takes the little power it needs through the light itself. Wire L to live, O to the lamp and SW1 to the wall switch. The N terminal is optional.

    Without a neutral, the Shelly 1L needs a load of at least 20 W. Most LED bulbs use less, which can make them flicker or glow when off, or stop the Shelly from starting. Shelly sells a small Bypass module for this, wired across the light. Check the manual of your model, since the newer Shelly 1L Gen3 uses its own Bypass 1L/2L Gen3. The 1L has no power metering, so in Home Assistant you get a light or switch entity and its inputs.

    Shelly 2.5 (2 channels or roller shutter)

    The Shelly 2.5 has two relays with power metering, so it can run two lights from one double switch. In roller mode it drives one motor instead, for shutters, blinds or a curtain. Switch the mode in its web page and run the calibration there, so the Shelly learns how long the motor takes to open and close. Home Assistant then shows a cover entity with an open percentage. A cover is Home Assistant’s name for anything that opens and closes.

    The Shelly 2.5 is discontinued. Its successor was the Shelly Plus 2PM, which has since been replaced by the Shelly 2PM Gen3 and Shelly 2PM Gen4. They do the same job and work with the same integration. A simple automation for a 2.5 in roller mode:

    alias: Close living room blinds after sunset
    triggers:
      - trigger: sun
        event: sunset
        offset: "00:15:00"
    actions:
      - action: cover.close_cover
        target:
          entity_id: cover.living_room_blinds

    Shelly Plug S

    The Plug S goes between the wall socket and your appliance. In Home Assistant you get a switch plus power and energy sensors, which you can add to the Home Assistant energy dashboard. A useful trick is turning a charger off when it is done:

    alias: Turn off charger plug when done
    triggers:
      - trigger: numeric_state
        entity_id: sensor.shelly_plug_s_power
        below: 3
        for: "00:10:00"
    actions:
      - action: switch.turn_off
        target:
          entity_id: switch.shelly_plug_s

    Use your own entity IDs. The for: line waits ten minutes so a short dip in power does not switch it off too early. For a plug that should look like a button on your dashboard, see our Home Assistant toggle switch guide.

    Firmware updates

    Each Shelly gets a Firmware update entity in Home Assistant, so new versions appear in Settings > System > Updates next to everything else. Click install and Home Assistant updates the device for you. Battery devices only report that an update is available. Wake them with their button and update them from their own web page or the app.

    Common problems

    • The device is not discovered. Home Assistant and the Shelly must be on the same network. Guest networks and separate VLANs block discovery. Add it by IP address instead.
    • Wall switch presses show up late (Gen1). Set the CoIoT peer from Step 3 and reboot the device. Across subnets, UDP port 5683 must be allowed.
    • The device keeps going unavailable. Wi-Fi is weak inside metal or deep switch boxes. Move the router or add an access point, and give the Shelly a fixed IP address.
    • LED lights flicker on a Shelly 1L. The load is too small. Add a Bypass module.

    Frequently Asked Questions

    Do Shelly devices need Shelly Cloud to work with Home Assistant?

    No. The Shelly integration talks to each device directly on your local network. Shelly Cloud is only needed for the Shelly app when you are away from home, and you can switch it off without affecting Home Assistant.

    Does the Shelly 1L need a neutral wire?

    No, that is the point of the Shelly 1L. It works with just live, load and the switch input. Without a neutral it needs a load of at least 20 W, so with small LED lights you usually add a Shelly Bypass module.

    What replaced the Shelly 2.5?

    The Shelly 2.5 is discontinued. It was followed by the Shelly Plus 2PM, and the current versions are the Shelly 2PM Gen3 and Shelly 2PM Gen4. They offer the same two channels or roller shutter mode with power metering.

    Why does Home Assistant show a CoIoT repair for my Shelly?

    Your Gen1 Shelly is not sending push updates to Home Assistant. Open the device’s web page, go to Internet & Security > Advanced Developer Settings, enable CoIoT, set the CoIoT peer to your Home Assistant IP with port 5683, save and reboot the device.

    Leave a comment

    Your email address will not be published. Required fields are marked *

    This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

    Coming soon
    The ready-made Home Assistant dashboard
    One email when it's ready, with an early-bird price. No spam. Privacy