Shelly Wi-Fi devices integrate natively with Home Assistant, making it easy to control lights, switches, relays, sensors and more – all locally, without relying on the cloud.
This guide walks you through how to add Shelly Wi-Fi devices to Home Assistant, common setup issues and best-practice tips.
Before you start, make sure you have…
Home Assistant Green (of Home Assistant OS hosted on your own hardware)
Shelly device connected to the same local Wi-Fi network as Home Assistant
Shelly device already powered on and configured to your Wi-Fi network
By far the easiest method… Most Shelly Wi-Fi devices should be automatically discovered by Home Assistant!
Here is how to check…
Open your Home Assistant Web Interface
Go to Settings > Devices & Services
Look for a notification saying…
“Discovered Shelly device”
Click Configure
Confirm the device(s) and finish setup
That’s it – your Shelly device should now appear as a new integration with entities ready to use.
If Home Assistant doesn’t automatically detect the device, you can add it manually.
How to add Shelly devices manually…
Open your Home Assistant Web Interface
Go to Settings > Devices & Services
Click Add Integration
Search for Shelly
Select Shelly
Enter the IP address of your Shelly device
Click Submit
Home Assistant should connect directly to the device and create the relevant entities.
Shelly device not discovered
Ensure Shelly and Home Assistant are on the same Wi-Fi subnet
Reboot the Shelly device
Restart Home Assistant
Try manual IP-based setup (method 2 above)
Shelly device shows as offline
Check Wi-Fi signal strength
Assign a static IP to the Shelly device
Disable AP isolation on your router
Seen a lower price in Australia? We'll always try to beat it. Read more.
$10 flat rate within Australia. Great rates to New Zealand. Read more.
Not happy with your purchase? We will refund your money. Read more.
We stand behind every product. Not a cliché - it's our promise. Read more.
