Shelly & Home Assistant
Shelly devices are Wi-Fi-based smart home products known for their compact size, local API support, and professional-grade reliability. The Home Assistant Shelly integration communicates directly with devices over your local network — no cloud account required.
Shelly offers switches, dimmers, plugs, sensors, and energy meters that fit behind existing wall switches. The Gen2 and Gen3 devices support both HTTP and WebSocket local APIs, providing instant state updates. For professional installers, Shelly’s combination of local control, compact form factor, and reasonable pricing makes them a go-to choice.
HA DocumentationHow Shelly Works with Home Assistant
Getting Shelly connected to Home Assistant and running reliably.
Connect your climate devices
Add Shelly through the integrations panel. Thermostats, sensors, and HVAC controls appear as entities with full temperature and mode control.
Zone-based management
Group Shelly devices by room or zone. Set different target temperatures for bedrooms, living areas, and unused spaces.
Smart scheduling & automation
Build automations that adjust Shelly based on occupancy, weather forecasts, or energy rates. Home Assistant learns your patterns and adapts.
Common Shelly Issues
The problems installers run into with Shelly and Home Assistant — and how a managed setup prevents them.
Gen1 vs Gen2/Gen3 API differences
Shelly Gen1 devices use CoIoT/CoAP for state updates while Gen2/Gen3 use WebSocket. Mixing generations in one installation requires different network configurations and may cause inconsistent behavior.
Firmware auto-update disruptions
Shelly's default auto-update setting can push firmware that temporarily changes API behavior. In rare cases, an update has broken Home Assistant compatibility until a new HA release patches the integration.
Wi-Fi congestion in large deployments
Each Shelly device is a Wi-Fi client. Installations with 30+ Shelly devices can overwhelm consumer routers, causing intermittent disconnections. Enterprise APs with higher client limits are needed.
Power monitoring accuracy drift
Shelly energy meters can show calibration drift over time, especially on lower wattage loads. Without periodic validation, energy dashboards display inaccurate consumption data.
Why installers choose managed Shelly setups
- Firmware updates tested before deployment with auto-update disabled on client devices
- Wi-Fi network designed for device density with proper AP placement and channel planning
- Unified Gen1/Gen2/Gen3 management with consistent monitoring across hardware versions
- Energy meter calibration verification against utility readings
Shelly devices we deploy
Hardware from the Selora catalog that runs on this integration. Every unit is tested and supported as part of a managed installation.
Light Strips
2 devicesPlus RGBW PM
A Wi-Fi and Bluetooth RGBW LED controller with four PWM channels and built-in power metering for 12/24 VDC strips. Drives RGBW, RGB, or up to four independent dimmable white channels with precise energy monitoring.
Pro RGBWW PM
DIN-rail RGBWW LED strip controller with five outputs (RGB + CCT or up to five channels) and per-channel power metering. Wired Ethernet plus Wi-Fi keep installations reliable on professional racks.
Switches & Dimmers
28 devices1 Gen3
Shelly 1 Gen3 is a Wi-Fi relay module with a dry, potential-free contact that wires behind an existing switch to add smart on/off control to almost any light or appliance.
1 Gen4
Compact multiprotocol relay switch with a potential-free (dry contact) output for switching lights, appliances, and low-voltage circuits. No neutral required and supports Wi-Fi, Bluetooth, Zigbee, and Matter for flexible integration.
1 Mini Gen3
Ultra-compact Wi-Fi relay that fits inside a wall box to switch lights or appliances via a potential-free dry contact, rated up to 8 A. Ideal for retrofitting existing switches without rewiring.
1 Mini Gen4
A compact Gen4 relay module with a potential-free (dry) contact output for switching lights, appliances, or low-voltage circuits in tight spaces. Multiprotocol radios let it run on Wi-Fi, Bluetooth, Zigbee, or Matter to fit almost any installer's ecosystem.
1PM Gen3
Shelly 1PM Gen3 is a Wi-Fi relay module with built-in power metering that wires behind an existing switch, adding smart control and energy monitoring to a single circuit.
1PM Gen4
Shelly 1PM Gen4 is a multiprotocol relay with power metering that wires behind a switch and speaks Wi-Fi, Bluetooth, Zigbee, and Matter, so it fits almost any smart home ecosystem.
1PM Mini Gen3
Shelly 1PM Mini Gen3 is an ultra-compact Wi-Fi relay with power metering, small enough to fit inside a back box behind a fixture or switch for discreet smart control of one circuit.
1PM Mini Gen4
A compact single-channel smart relay with built-in power metering that fits inside a standard wall box. Supports Wi-Fi, Bluetooth, Zigbee, and Matter for flexible integration into any smart home.
2PM Gen3
Shelly 2PM Gen3 is a dual-channel Wi-Fi relay with power metering that controls two independent circuits or drives a single roller shutter or motorized cover with position feedback.
2PM Gen4
Dual-channel Wi-Fi relay with per-channel power metering and a roller/cover mode for motorized blinds and shutters. Multiprotocol Gen4 hardware adds Bluetooth, Zigbee, and Matter for flexible integration.
DALI Dimmer Gen3
Wi-Fi DALI dimmer that controls DALI-compatible light sources over the DALI bus, powering and managing up to five unpowered DALI devices. Adds smooth dimming and scene control to professional lighting installs.
Dimmer 0/1-10V PM Gen3
Shelly Dimmer 0/1-10V PM Gen3 is a Wi-Fi controller for 0/1-10V dimmable drivers and ballasts, with built-in power metering for commercial and architectural lighting.
Dimmer Gen4
Multiprotocol in-wall dimmer with trailing-edge dimming up to 200 W, optional no-neutral operation, and power metering when wired with neutral. Connects over Wi-Fi, Bluetooth, Zigbee, or Matter so it fits almost any smart home stack.
Plus 1
A compact Gen2 Wi-Fi relay with a dry (potential-free) contact for switching lights, appliances, gates, and low-voltage circuits. Works with or without a neutral and needs no power-metering hardware, making it a flexible drop-in for almost any switching job.
Plus 1PM
Wi-Fi relay switch with built-in power metering, rated for up to 16A across 110-240V AC or 24-30V DC loads. Adds accurate energy monitoring to any light, appliance, or circuit for local, app-free control.
Plus 2PM
Dual-channel Wi-Fi relay with per-channel power metering for two independent loads or a single roller shutter. Obstacle detection and a safety switch make cover control reliable for blinds, awnings, and garage doors.
Plus Uni
A compact universal Wi-Fi module with two potential-free relay outputs, digital and analog inputs, a pulse counter, and a 1-Wire bus for DS18B20 or DHT22 sensors. Ideal for integrating low-voltage devices and existing sensors into a smart system.
Plus Wall Dimmer
Shelly Plus Wall Dimmer is a Wi-Fi in-wall dimmer with a capacitive front that sets the brightness of dimmable lights, replacing a standard wall switch.
Pro 1
DIN-rail mountable Gen2 smart relay with a single potential-free (dry) contact channel rated to 16A. Wired LAN plus Wi-Fi connectivity gives professional installs reliable, redundant control for lights and appliances.
Pro 1PM
Shelly Pro 1PM is a DIN-rail mounted relay with power metering and wired Ethernet, built for breaker panels and professional installs that need a single switched and monitored circuit.
Pro 2
Shelly Pro 2 is a DIN-rail mounted 2-channel relay with potential-free (dry) contacts and wired Ethernet, built for breaker panels and professional installs controlling two independent loads.
Pro 2PM
Shelly Pro 2PM is a DIN-rail dual-channel relay with per-channel power metering that controls two circuits or drives a single roller shutter, with Wi-Fi, Ethernet, and Bluetooth for reliable panel connectivity.
Pro 3
DIN-rail Wi-Fi, Bluetooth, and Ethernet smart relay with three independent 16 A channels for professional installations. Wired LAN delivers rock-solid local control in panel and cabinet deployments.
Pro 4PM
DIN-rail 4-channel smart relay with per-channel power and energy metering, a color LCD display, and wired Ethernet plus Wi-Fi for rock-solid professional installs. Each output is independently controlled and monitored for precise load management.
Pro Dimmer 0/1-10V PM
A DIN-rail Wi-Fi and Ethernet dimmer that drives 0-10V and 1-10V ballasts and LED drivers with built-in power and energy metering. Gives installers precise lighting control plus accurate consumption data on a single professional module.
Pro Dimmer 1PM
DIN-rail Wi-Fi, Bluetooth, and Ethernet trailing-edge dimmer with a single 200 W output and built-in power and energy metering. Wired LAN delivers reliable local control for panel and cabinet installations.
Pro Dimmer 2PM
DIN-rail two-channel trailing-edge dimmer with per-channel power and energy metering for professional lighting installations. Wired Ethernet plus Wi-Fi and Bluetooth ensure rock-solid connectivity in the panel.
X MOD1
Compact OEM embedded wireless module (ESP-Shelly SoC) that adds 2.4 GHz Wi-Fi and Bluetooth 5 to appliances and IoT products. Exposes up to 8 configurable inputs/outputs and Shelly scripting so manufacturers can build connected, hub-free devices.
Controls
7 devicesBLU Button Tough 1
A rugged, water- and dust-resistant battery button that triggers scenes and controls devices over Bluetooth Low Energy with multi-click actions. Sold in Bluetooth (BTHome) and Zigbee variants for flexible smart home control.
BLU Button1
Shelly BLU Button1 is a compact battery-powered Bluetooth scene controller that triggers scenes and automations with single, double, triple, and long-press actions. It broadcasts in BTHome format for direct, local control without cloud dependency.
BLU RC Button 4
Battery-powered four-button Bluetooth remote for triggering scenes and controlling devices, supporting single, double, triple, long and multi-tap actions. Sold in Bluetooth (BTHome) and Zigbee variants for flexible integration.
BLU Remote Control ZB
Shelly BLU Remote Control ZB is a battery-powered handheld scene controller with navigation buttons, ring keys, a scroll wheel, and a motion accelerometer. The ZB model speaks both Bluetooth and Zigbee, and a Bluetooth-only BLU variant is also sold.
i4 Gen3
Shelly i4 Gen3 is a Wi-Fi input module that turns up to four wired buttons or switches into scene and automation triggers without controlling a load itself.
Plus i4
A Wi-Fi and Bluetooth scene controller with 4 switch/button inputs that triggers scenes, automations, and webhooks from wired wall switches or buttons. Powered from 110-240 VAC and installs behind existing switches to add smart control without replacing them.
Plus i4 DC
Wi-Fi and Bluetooth input controller with four low-voltage switch/button inputs powered by 5-24 VDC. Lets installers add physical scene control and trigger complex automations from any dry-contact or momentary switch.
Sensors & Environment
9 devicesBLU Distance
Battery-powered Bluetooth ultrasonic sensor measuring distance and fill level from 200 mm to 5000 mm. Ideal for tank, bin, and water-level monitoring with up to four years of battery life.
BLU Door/Window
Battery-powered contact sensor that reports open/close state, tilt-and-turn angle, and ambient lux, with up to five years on a single CR2032 cell. Sold in Bluetooth and Zigbee (ZB) variants for flexible integration.
BLU H&T
A compact battery-powered Bluetooth temperature and humidity sensor with a CR2032 cell and roughly three-year battery life. Sold in Bluetooth and Bluetooth+Zigbee (ZB) variants, both splash and dust-resistant for kitchens, bathrooms, and basements.
BLU H&T Display ZB
Battery-powered temperature and humidity sensor with an e-paper display showing real-time readings and a clock. Sold in Bluetooth and Zigbee variants for flexible smart home integration.
BLU Motion
Battery-powered motion sensor with a built-in illuminance (lux) meter for triggering lighting and scenes based on real activity and room brightness. Sold in Bluetooth (BLU) and Zigbee (BLU Motion ZB) variants for flexible integration.
Flood
Shelly Flood is a battery-powered Wi-Fi water leak sensor that fires the moment its contacts detect water, and also reports ambient temperature for early freeze warnings.
Flood Gen4
A battery-powered Gen4 water leak sensor with a 2 m extendable leak-detection cable (up to 150 m) for catching leaks along pipes, walls, and large floor areas. Multiprotocol over Wi-Fi, Bluetooth, Zigbee, and Matter, with selectable Flood and Rain operating modes and IP44 protection.
H&T Gen3
Shelly H&T Gen3 is a battery-powered Wi-Fi temperature and humidity sensor that reports room conditions to Home Assistant for climate and comfort recipes.
Presence Gen4
A USB-C powered 60-64 GHz mmWave radar presence sensor that detects stationary occupants across up to 10 zones, with a built-in illuminance sensor for lighting-aware automations. Multiprotocol Wi-Fi, Bluetooth, Zigbee, and Matter for flexible integration.
Security & Safety
1 devicePlugs & Power
2 devicesPlug US Gen4
A multiprotocol US smart plug rated for 15 A (1800 W) with built-in power and energy metering. Connects over Wi-Fi, Bluetooth, Zigbee, or Matter for flexible local control across ecosystems.
Plus Plug US
A Wi-Fi and Bluetooth smart plug with built-in power and energy metering, rated up to 10 A. Gives installers precise per-device consumption data and reliable on/off control for any plugged-in load.
Energy & Solar
8 devices3EM-63 Gen3
Compact DIN-rail energy meter that monitors a three-phase system or three independent single-phase circuits up to 63 A per phase. Tracks voltage, current, active and apparent power and energy with 4-quadrant measurement for whole-home or sub-circuit visibility.
EM Gen3
Compact two-channel Wi-Fi energy meter that measures consumption with two current transformer clamps up to 80A per channel. Includes a dry-contact relay for contactor control of heavy loads like water heaters and heat pumps.
EM Mini Gen4
A compact single-phase energy meter that measures active power and energy on one circuit via direct screw-terminal connection. Gives installers accurate, real-time consumption data without bulky CT clamps.
PM Mini Gen3
Shelly PM Mini Gen3 is an ultra-compact Wi-Fi power meter that clips behind a fixture or socket to measure a circuit's voltage, current, and energy without switching the load.
Pro 3EM
DIN-rail three-phase energy meter that measures voltage, current, power and power factor across all three phases via 120 A current transformers. Stores roughly 60 days of on-device data with 1-minute resolution for accurate consumption and production monitoring.
Pro 3EM-3CT63
A three-phase DIN-rail energy meter that measures active and apparent power, energy, and power factor across three phases plus neutral using 63A CT clamps. Wired Ethernet and Wi-Fi deliver reliable real-time monitoring for panel-level installations.
Pro 3EM-400
DIN-rail three-phase energy meter with included 400A current transformers, measuring per-phase voltage, current, power, and bidirectional energy with 1% accuracy. Wired Ethernet plus Wi-Fi keeps panel-level monitoring rock solid for whole-building loads.
Pro EM-50
DIN-rail single-phase energy meter with two metering channels measuring voltage, current and power via clamp-on 50 A current transformers, plus a built-in dry-contact relay for contactor control. Stores at least 60 days of on-device data at 1-minute resolution for accurate consumption and production monitoring.
Frequently Asked Questions
More Climate & HVAC Integrations
Ready to Install Shelly Professionally?
Stop troubleshooting Shelly integration issues. Let Selora handle the setup, monitoring, and maintenance so you can focus on your clients.