Connecting Shelly devices to Home Assistant creates a powerful foundation for your smart home automation system. Whether you're new to home automation or expanding an existing setup, this guide walks you through every step needed to integrate Shelly products with Home Assistant for seamless control of your home environment.
Getting Started with Shelly and Home Assistant Setup
Before diving into technical configurations, understand that Shelly and Home Assistant work together to give you centralized control over multiple devices. The integration process is straightforward but requires a few preparatory steps. First, ensure your Shelly device connects to your Wi-Fi network using the Shelly Smart Control app. This initial setup is crucial because it gets your device online and discoverable by Home Assistant.
Once your device is on your network, Home Assistant can detect it automatically through discovery, or you can add it manually by entering the device's IP address. The beauty of this integration is that you gain access to advanced home automation features that aren't available through the standard Shelly app alone.
Automatic Discovery and Manual Configuration Methods
Home Assistant offers two primary paths for adding Shelly devices. The first method leverages auto-discovery, which happens automatically when your Home Assistant instance finds compatible devices on the network.[1][2] When discovered, your device will appear in the discovered devices section and can be set up immediately with minimal configuration.
If automatic discovery doesn't work, don't worry. The manual configuration process is equally straightforward.[2] Navigate to Settings > Devices & Services in Home Assistant, click the "Add Integration" button, search for Shelly, and enter your device's local IP address. This manual approach works particularly well if you have multiple Shelly devices or complex network setups.
Step-by-Step Integration Process
Setting up Shelly devices with Home Assistant involves several manageable steps:
- Install batteries in wireless devices like the Shelly H&T sensor
- Connect your device to Wi-Fi using the Shelly Smart Control app
- Note your device's IP address from the Shelly app settings
- Open Home Assistant and navigate to Settings > Devices & Services
- Click "Add Integration" and search for Shelly
- Enter the device IP address and follow on-screen instructions
- Press the physical button on your device if prompted to complete pairing
- Wait for entities to appear in Home Assistant
The entire process typically takes less than five minutes per device, and subsequent devices integrate even faster once you understand the workflow.
Configuring CoIoT Protocol for Optimal Performance
An important configuration step involves the CoIoT peer setting, which enables efficient local communication between your Shelly device and Home Assistant.[2] This is particularly critical for battery-operated devices. To enable CoIoT, enter your Home Assistant server's local IP address and port 5683 into the CoIoT peer field in your Shelly device settings, then save these changes.
After modifying the CoIoT peer configuration, manually restart your Shelly device to apply the new settings. This ensures reliable, low-latency communication that reduces cloud dependency and improves response times for your smart home automation routines.
Voice Control Integration with Alexa and Google Assistant
Connecting your Shelly devices to voice assistants extends your smart home capabilities significantly. For Google Assistant integration, download the Shelly Smart Control app, add your devices, then open Google Home, navigate to Settings > Works with Google, search for "Shelly Smart Home," and complete the authentication process.[1]
Amazon Alexa integration follows a similar approach. In the Alexa app, go to the skills tab, search for "Shelly Smart Control," and enable the skill. Once connected, you can control your Shelly devices using voice commands through any Alexa enabled speaker or display in your home.
Managing Multiple Devices and Sub-Devices
When you have multiple relay channels on a single Shelly device, Home Assistant creates sub-devices for organization.[2] The integration intelligently names these devices based on their function. If you've set a device name in the Shelly settings, Home Assistant uses that for main device identification. For multi-relay devices, each relay gets its own entity name for clarity.
This hierarchical organization keeps your Home Assistant interface clean and manageable, even with dozens of connected Shelly devices throughout your home.
Accessing Configuration Options
After initial setup, you can modify your Shelly device settings within Home Assistant at any time.[2] Navigate to Settings > Devices & Services, select the Shelly integration, and click Configure. This interface lets you adjust device names, modify communication settings, and fine-tune how your devices behave within your broader home environment.
Advanced Features and Automations
Once integrated, your Shelly and Home Assistant setup unlocks advanced possibilities beyond basic control. You can create complex automations that trigger based on time, temperature, motion detection, or other sensors. This enables energy-efficient climate control, automated lighting sequences, and intelligent device management that adapts to your lifestyle.
The smart home automation possibilities expand dramatically when you combine Shelly's hardware capabilities with Home Assistant's powerful automation engine, creating a truly responsive living environment.
Troubleshooting Connection Issues
If your Shelly device doesn't appear in Home Assistant after setup, verify several factors first.[5] Ensure the device stays powered and connected to your Wi-Fi network. Battery-powered devices may sleep after brief inactivity, so keep them plugged in during troubleshooting. If integration keeps failing, try rebooting your DHCP server or performing a full Home Assistant restart.
Sometimes the IP address hasn't officially propagated through your network yet. Waiting a few minutes and retrying often resolves this issue. For persistent problems, consult the device's web interface directly by entering its IP address in a browser to verify its network status.
Final Thoughts on Shelly and Home Assistant Integration
Successfully connecting Shelly and Home Assistant transforms your approach to smart home management. The straightforward integration process, combined with powerful home automation capabilities, makes this combination ideal for anyone serious about intelligent home control. Whether you're automating lighting, managing power consumption, monitoring environmental conditions, or coordinating complex routines across multiple rooms, this integration provides the foundation for sophisticated IoT devices coordination that genuinely improves daily life in your home.