Skip to main content
Skip table of contents

Shelly 2.5 web interface guide

To connect to your Shelly 2.5, connect your device to the Wi-Fi network with a name(SSID) like shelly25 - 84CCA87D1A78. Use the universal IP address for all Shelly devices - to access your device's Web Interface, where you can set a Wi-fi network for the Shelly 2.5 to connect to. Once done, through the app on your mobile device or through, you can go into the Settings and search for Device information. There you will find the Device IP and be taken to the Web Interface of Shelly 2.5.

Cover/Roller Mode

General - Home page

In the web interface, you will see three icons at the top of the screen, including one for Wi-Fi and Cloud connection, as well as an icon indicating the state of the web interface(password protected or not). Here is what the different status colors mean:

  • Wi-Fi icon:

    • Red: Wi-Fi connection is disabled.

    • White: Wi-Fi connection is enabled, but not established.

    • Green: Device is connected to Wi-Fi.

  • Cloud icon:

    • Red: Connection to Shelly Cloud is disabled.

    • White: Connection to Shelly Cloud is enabled, but not established.

    • Green: Device is connected to Shelly Cloud.

  • Lock icon:

    • Red: The web interface of your device is not password protected.

    • Green: The web interface of your device is password protected.

In the home page of the Web Interface, you will see an open, close and pause button, as well as the power the device is using. To open or close partially, go to the settings and do a calibration.

Weekly Schedule

This function requires a working connection to the Internet, so the device can synchronize the time. It allows you to create, view, edit, and delete schedules.

To create a schedule:

  • Select the day(s) of the week.

  • Choose a time interval: time, sunrise, or sunset.

  • Set the time for the specified day(s):

    • Time: Click the up/down button, or type in a number, to set a time in hours and minutes.

    • Sunset/Sunrise: The Shelly device may turn on/off (or do specified action) automatically at sunrise/sunset, or at a specified time before or after sunrise/sunset. Click the up/down button, or type in a number, to set a time in hours and minutes.

I/O URL Actions

The actions include roller open, close and stop. If you want to enable a specific action, click the checkbox next to Enable and type in the URL to be hit when the action happens. Мore than 2 actions can affect the normal operation of the device depending on the network infrastructure and the controlled devices.

Internet & Security


In this setting, you can connect your Shelly 2.5 to your home network by selecting a Wi-Fi network and typing in its password. Enable Wi-Fi Client only, or both Wi-Fi Client and Wi-Fi Client Back-up. If both are enabled, and the Shelly device disconnects from the first network, it will connect to the other one. When connecting your device to your home network, you can also set a static IP address for your device to acccess it at.


Enabling this setting will make it so the device periodically scans for a better access point when the RSSI signal strength value is below the one you have chosen from the drop-down menu.

Access point

Configure the device's AP, including switching it on or off, and setting a password. The access point of the device is an open network by default. The SSID is unique and cannot be changed.


Once you’ve enabled this setting, you will type in a username and password, which will be used as login credentials every time you visit the device’s Web UI. This setting is responsible for the lock icon in the home page of the web interface and when it’s enabled the icon will be green and the lock will be closed.


SNTP synchronizes your device's system time with a server that has already been synchronized by another source. There is already a set server, which is the default one -, however, if there are any problems, you can easily change it and enter a new one in the text box. Changing this setting will reboot the device.


In this setting, you can enable/disable Cross-Origin Resource Sharing, CoIoT and MQTT. If you enable CoIoT, a text box will appear, where you can type in the CoIoT peer. There you can enter mcast for multicast or ip:port for unicast. A device is required when the CoIoT peer is changed.

You can also enable MQTT, but actions via Cloud connection will be disabled.


Connecting your Shelly to its cloud allows you to control it remotely, and receive notifications and updates about your devices. The default for this setting is for the cloud to be enabled. If you disable the device cloud support, you will lose connection to your device from outside its local network!



Select when obstacle detection is activated:

  • Disabled - Disables obstacle detection.

  • While Opening - Detects obstacles while the device is in the process of opening.

  • While Closing - Detects obstacles while the device is in the process of closing.

  • While Moving - Detects obstacles while the device is moving.


  • Activation - The safety switch could be activated during opening, closing and/or moving. This function can also be disabled. You can select when you’d like the safety switch to be activated by checking the box next to the corresponding setting.

  • Action - Select the action to be executed when the safety switch is triggered - either stop, pause or reverse.

  • Allowed Commands - Select which commands the device is allowed to exeute when the safety switch is triggered (none, open, close or all).


Enabling the Custom Max Power Protection option allows you to configure the device to turn off when the power consumption reaches a certain value. You can type that value in the text box, but it must be between 1W and 2300W.



  • Relay - a standard Shelly relay with ON and OFF states, which can be used to control various appliances.

  • Roller Shutter - the Shelly roller mode supports UP, DOWN and STOP commands and provides different settings. It’s useful for controlling different types of Door and Window Rollers.


Configure the Shelly device to do one of three things when it has power:

  • Open

  • Close

  • Stop


Configure the time in seconds after which the Shelly roller will automatically STOP and move to a:

  • OPEN state

  • CLOSE state


Set the delay in milliseconds, after which the roller won’t be able to move anymore.


  • One Button - Every time Button 1 is pressed, the roller will follow the next sequence step(Open, Close, Stop, etc.) and will only use this button for controlling the device’s state.

  • Open & Close Buttons - Use seperate buttons to OPEN and CLOSE.


Set relay type:

  • Follow: (Switch only) - Set Shelly device to be Toggle switch. Act as a flip switch with one state for ON and one state for OFF.

  • Momentary: (Button only) - Set Shelly device to be Momentary switch. Push for ON or Push for OFF.

  • Flip: (Switch only) - Set Shelly device to be Edge switch. Changes state on every hit.

  • Detached: (Button and Switch) - Set Shelly device to be in Detached switch mode - switch is separated from the relays.

  • Reverse inputs - Invert the On/Off position, aka the device will consider the switch to be on when it is off and vice versa.


Reverse the Open/Close logic.


This setting should be enabled if the directions of your device don’t match the ones in the interface.


Enabling positioning controls requires calibration afterwards. After you’ve enabled this, click the button underneath Calibrate.


Your timezone and location will be autodetected, but you can manually change them from this setting by choosing a timezone from the drop-down menu and typing in your latitude and longitude. There is also a button Auto detect location, which will make the device automatically detect the location once again if it failed the previous time.


Name/Rename your device.


From this setting you can disable the device’s Wi-Fi status light, which indicates the mode your device is in.


The device can check for new firmware and you can choose to update it if a new version is available.


Factory resetting the Shelly device will bring it back to its factory settings, disconnect it from all Wi-Fi networks and all associated users, including you, will be removed from the device.

Before you can control the device again, you’ll have to add it to your account again as a new device.


Reboot your device.


Make your device discoverable by other devices.

Eco mode

Reduce the energy consumption of your device by lowering the CPU frequency and modem activity. Enabling Eco Mode can help you conserve power and extend the battery life of your device.

To enable Eco Mode, simply toggle the switch next to "Enable eco mode." Once you've done that, click the "Apply" button to save the changes. Your device will then automatically adjust its CPU frequency and modem activity to reduce power consumption.


See information about your device, including the device ID, the Wi-Fi network it’s connected to, the RSSI of the Wi-Fi and the debug log. Enabling the debug log without a reason isn’t recommended, since your device will be slowed down and this setting will cause aging of the flash memory. If you do decide to enable it, you can also download the previous and current logs.

Relay mode

General - Home page

In the home page of the Web Interface of the device in relay mode, you will see the power consumption of the device, the two channels with power buttons next to them and their individual power consumption. There’s also a gear icon next to each of the channals, where you can edit the settings for that channel.

Internet & Security

These settings are the same in both modes of the device(relay and roller). They are explained above.


The majority of the device settings for both modes are the same. Relay mode has these settings:

  • Device type - here you can set your device mode to roller or relay.

  • Time zone and geo-location

  • Firmware update

  • Factory reset

  • Device reboot

  • Device discoverable

  • Device info

These settings are already explained above in the Settings section of the Roller mode guide.

Relay mode also has LONG PUSH TIME, which is a setting, where you can customise the time in milliseconds your device recognises as a long push.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.