The web interface serves as an agile web server, providing you with a seamless gateway to access and oversee your devices through a standard web browser on either your computer or mobile device. Its functionality encompasses an array of adjustment and control features, including the ability to power your device on or off, track energy consumption, set schedules, and execute scripts as needed.
Accessing the web interface
Connect your device to a Wi-Fi network with a name (SSID) that follows this format: "DeviceName-XXXXXXXXXX", where ‘DeviceName’ is the name of the device you’d like to connect to, while 'XXXXXXXXXX' represents a unique combination of letters and numbers, constituting the device ID. For instance, the SSID might appear as "ShellyPlus1PM - 84CCA87D7CDC”.
After establishing a connection to the device’s Access Point / AP (the Wi-Fi network mentioned in step 1), accessing the web interface is done by entering the universal IP address for all Shelly devices 192.168.33.1 in your browser.
You are now in the web interface of your device.
Connecting your device to a Wi-Fi network
Some of the settings you’ll see in the web interface are only available if the device is connected to the internet. To do that, follow these steps:
From the Web interface, navigate to Settings>Wi-Fi.
Either input or select your preffered Wi-Fi network and then enter its password. Alternatively, connecting to an open network is also an option, facilitated by selecting the checkbox for connecting to open Wi-Fi networks. Additionally, it is recommended to set a static IP address.
Allow your device a few seconds, so it can try to connect to the Wi-Fi network you provided. If the password you typed in is incorrect, or the Wi-Fi network lacks sufficient strength or stability, a message will be displayed in the web interface, notifying you that a connection couldn’t be established. Upon successful connection to the Wi-Fi, a link, containing the new IP address will appear as text above the Wi-Fi settings. Simply copy and paste this link into your browser.
You are now in the web interface of your internet-connected device. The next time you need to access the web UI, simply connect to the same Wi-Fi network as your device and type in the new IP address, obtained in step 3. Setting a static IP address is reccomended, because it guarantees consistent accessibility at that specific address.
Understanding the layout
The web interface can be divided into four main sections - the header, footer, main menu and main content.
The header consists of two components - the name of your device on the left and a few icons, which display your device’s main network and connectivity features on the right. These icons can encompass functionalities such as Wi-Fi, Bluetooth, MQTT, and more. Hovering with your mouse on an icon will provide you with further information. You’ll find a legend with the meaning of each icon in the web interface guide of each device. Please note that the individual guides explain only the connectivity features available for that specific device.
At the bottom of the screen from left to right in order are the device model name, its ID, the version of the web interface, the firmware version of the device and finally, the current time. Some previous versions of the web interface do not include all of these components.
The main menu in the desktop version of the web interface is on the left, whereas on mobile, it looks like a hamburger menu with an icon of three horizontal lines, stacked on top of each other. The menu contains different things, depending on the device, but clicking an item from it takes you to a different page. You can also use it to get back to the Home page by clicking Home.
By clicking on an item from the main menu, you’ll be able to navigate through the web interface. Everything that you see on the screen, excluding the header, footer and main menu is considered main content.
*Please note that not all of the web interface screenshots displayed at the top of each web interface guide page (where there is a screenshot present) are of the latest version. Therefore, they may look a bit different than the latest version and may not represent the look of every device's web interface.
Below are explanations of each setting in the main menu, including what is visualised as main content upon clicking on the different settings. A brief introduction of the icons in the header, specific to this device, is also present in the Home page explanation. Note that the header is present in all of the screens, not just the Home page.
In the web interface, you will see five icons in the header, including one for AP, Wi-Fi, Bluetooth, Cloud and MQTT connection. Here is what the different status colors mean:
In the home page of your device’s web interface, there are three view options. In the Classic view, you will notice the readings for the phases are split into columns for each phase - A, B and C. While each column shows the individual readings of the phases, including voltage, current, active power, apparent power and power factor, the above table labelled Total shows the sum of the readings for each phase.
The voltage, current and active power readings are measured, respectfully, in volts, amperes and watts. The apparent power is measured in volt-amperes.
The power factor can be:
Positive (over 0), indicating inductive loads.
Negative (under 0), indicating capacitive loads.
Under each table for phases A through C is a section titled Energy last minute. These are the readings for the specific phase in the past minute, regarding the active and active returned energy in megawatt hours.
The Diagram view visualises the readings seen in the Classic view by using a diagram of the device and labelling each part with the corresponding value. Here you’ll also notice the three phases have their own readings displayed, as above each phase are the current and power readings, somewhat like in the Classic view.
In the Energy graphs view, each phase has two menus dedicated to it - Phase (and its name, in this case A-C) and Phase (its name, in this case A-C) returned. They help to visualise the energy values in Wh for the past 30 minutes, seperating the power into active and active returned. You’ll notice this view is like a more detailed version of the Energy last minute menu in the Classic view.
In each of these views, the Download CVS file button will be available. By clicking the < button next to this option, you can choose to download a file, including:
Readings in the last n hours, where n is a value you can type in.
Readings in the last n days, where n is a value you can type in.
Everything - all of the data your device has gathered since it was set up and turned on for the first time.
When you click on the Settings menu next to overview, you’ll be taken to:
Energy meter settings
Energy meter name - Name/rename your EM.
Reverse CT measurement direction - Reverses the direction, in which the current transformer (CT) measures the electric current for one or more of the phases. Depending on your wiring, you might want to apply this setting to some or all of the phases (A, B and C). Select the one/s you’d like to change the measurement direction of and click Save Settings.
Blink mode selector - Choose the way your device’s LED status light will be controlled - by the Active energy or Apparent energy. The chosen electrical quantity will drive the LED and the LED light's state will be changed according to it.
Phase selector - All phases can control the LED at once, or you can pick a specific phase you’d like to have complete control of the LED. If you choose one phase, changes in readings for the other phases won’t affect the LED.
Monitor phase sequence - Enabling this setting will allow for your device to check for and notify of incorrectly placed Current Transformers (CTs) in a three phase system.
Delete stored data - Delete all of the readings your device has gathered so far.
Configure the actions for your device - create new actions, edit existing actions or delete actions. When creating actions for your device you will need to specify the condition on which the action occurs. You can also set a duration for your actions, as well as a URL to be hit when the condition for the action is met.
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.
WiFi - Register the Shelly device to connect to up to 2 different Wi-Fi networks.
Either input or select the Wi-Fi network. Can select an open network, and also set a static IP address.
Enable Wi-Fi 1, or Wi-Fi 2, or both at the same time. If both Wi-Fi 1 and Wi-Fi 2 are enabled, and the Shelly device disconnects from one of the networks, it will connect to the other.
Bluetooth - Disable/enable Bluetooth by toggling the switch. The device's default Bluetooth setting is enabled.
Ethernet - you can connect your device using Ethernet, instead of Wi-Fi. Like in the Wi-Fi settings, you can set a static IP adress for your device (which is recomended) to acces your device at the same IP adress every time. If static IP is enabled, you will be prompted to provide the IP adress, DNS server, gateway and network mask.
Cloud -Connecting your Shelly to its cloud allows you to control it remotely, 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!
MQTT - Configure the Shelly device to execute actions via MQTT. By default, MQTT is disabled, but you can enable it by toggling the switch. Changing these settings will cause the device to reboot. There are some other settings, such as RPC status notifications over MQTT (which enables you to communicate with your device through RPC notifications) and Generic status update over MQTT (to get an overall status update), which you can enable/disable by toggling the switches on their right. You can also enable SSL and type in your server, username and password, but be aware that enabling SSL will hurt the battery life and most likely shorten it by half.
Outbound Websocket - Specifies whether the HTTP channel creates an I/O exception when an inbound connection is closed while still in use by the servlet. By default, this setting is disabled. To enable it, click the toggle switch next to Enable. Enter your service address in the text box and from the drop-down menu under SSL Connectivity choose *, ca.pem or user_ca.pem.
Range extender - Turning on the Range extender feature creates a hotspot that you can connect Wi-Fi devices to. If a Shelly device with the range extender enabled is connected to a Wi-Fi router and the Internet, all devices connected to it are also connected to the router and the Internet.
Even if the Shelly device is not connected to a Wi-Fi router, all devices connected to it can still communicate with it and with each other.
RPC over UDP - Communicate with your device and send requests through a Remote Procedure Call (RPC) over a User Datagram Protocol (UDP) server. This can be useful in controlling and monitoring your device remotely, without the need for a dedicated server or connection.
To use this setting, you'll need to enter the listen port and destination address for the UDP server. The listen port is the port number that the device will listen on for incoming requests, while the destination address is the IP address of the server that the requests will be sent to.
Once you've entered the required information, you can use the RPC over UDP protocol to send requests to your device and receive responses.
Device name (info) - See your device’s ID, the Wi-Fi it’s connected to and the Wi-Fi RSSI.
Reboot device - After clicking on the Reboot button, you will be asked if you’re sure you want to reboot your device. Click OK for device reboot and Cancel if you don’t want the device to reboot.
Factory reset device - By clicking on the Reset button, your device’s settings will all be reset to the default. Any changes you’ve made will be reverted. You can confirm that you want the device to factory reset by clicking OK on the pop-up, or Cancel to cancel the factory reset.
Location and time - 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.
Authentication - If you enable authentication, you will be asked to type in a password, which you will then use to access the Web UI of the device. Once enabled, to disable it, click the toggle and enter your authentication pass once prompted.
Firmware - In this setting, you can see your device's ID, Firmware version and build ID, as well as the Web build ID. You can also see the available new versions, check for updates and easily update your device. There is also an option to upload your own firmware, however flashing devices with custom firmware irreversibly voids the device warranty.
User certificate - Upload custom SSL certificate by dragging and dropping the file or by browsing your files, which you can do by clicking the designated button.
Eco mode - Reduce energy consumption on the device by lowering CPU frequency and modem activity while in Eco Mode. To enable this setting click the toggle switch next to Enable eco mode and then click the Apply button to save the changes.
Debug - This setting includes Mqtt, Websocket and Udp debug. To enable any of these, click the toggle switch next to the specific setting. For Udp debug you will also be asked to type in a udp address.
Units - Choose the units the measured data will be displayed in.
Upon clicking on the arrow next to this setting, you will reveal the advanced settings. They are explained below.
KVS stands for Key-Value Storage and is a type of non-relational database, which works by using a simple key-value method to store data. In one device, you can store up to 50 key-value pairs. Upon clicking on the Add value button, you will be taken to the value creation screen, which prompts you to enter a key (up to 42 characters), and value (up to 253 characters). You’ll notice under the text box for the value is the current value type. By default, the value type is Number, but by entering text, the type will change to String. To save the key, simply click the Save button. To edit an existing value, simply click on it. To delete a key-value pair, click the Delete button that appears below it when you go to edit the key. Clicking on the question mark next to the setting name will take you to the API documentation, which will provide you with further information on how the KVS works for Shelly devices.
From this setting you can download the debug logs. 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. Be aware that leaving this page will reset the logger and logged data.