> For the complete documentation index, see [llms.txt](https://cube.ewelink.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cube.ewelink.cc/resources/change-log.md).
# Change Log
## v2.14.1 - Sep. 29 2026
We have released patch v2.14.1 to resolve several issues from V2.14.0.
### Bug Fixes
1. Fixed an issue where SONOFF AirGuard TH (SNZB-02DR2) did not display temperature readings from the external sensor configured in CUBE after updating its firmware to version 1.0.5.
2. Fixed an issue where Matter Bridge could become unavailable after syncing cameras on CUBE (v2.14.0).
***
## v2.14.0 - Sep. 18 2026
This release expands **Matter Bridge capabilities and device support**, and improves eWeLink-linked device syncing, scenes, CAST, Node-RED, and overall stability. Please take a moment to read through the notes before updating to this version.
### What's New?
1. **New Device Support**
* Added support for SONOFF S61SZBTPB Zigbee smart plug.
2. **Enhanced eWeLink-linked Device Sync Support**
* The eWeLink Smart Home Add-on and built-in "Add eWeLink-linked Devices" feature now support syncing:
* SONOFF Hydro ONE smart water valves (SWV-ZFE / SWV-ZFU)
* SONOFF Hydro ONE Lite smart water valves (SWV-ZNE / SWV-ZNU)
* SONOFF Hydro DUO dual-channel smart water valves (SWV-ZF2E / SWV-ZF2U)
* SONOFF MINI Extreme Zigbee Dimmer Switch (MINI-ZBDIM)
3. **Matter Bridge Enhancements**
* Added support for syncing the following Matter/Zigbee device types to Matter-enabled platforms via Matter Bridge:
* Pressure Sensor
* Siren
* Expanded Air Quality Sensor support with the following measurement capabilities:
* Formaldehyde Concentration
* Nitrogen Dioxide Concentration
* Ozone Concentration
* PM1 Concentration
* PM10 Concentration
* Radon Concentration
* Expanded Boolean State Configuration cluster support for:
* Occupancy Sensors now support sensitivity adjustment.
* Water Leak Detectors now support enabling or disabling tamper alerts.
* Optimized color-light mapping to ensure color adjustment works correctly after bridging to Samsung SmartThings.
* Changed Matter Bridge mapping for multi-function devices to use multiple endpoints instead of compose, improving device compatibility.
4. **Device and Automation Enhancements**
* SONOFF BASIC-ZB1GSP now supports bi-directional energy monitoring, allowing users to view up to 12 months of energy history.
* Scene triggers based on power consumption now support value ranges.
* CAST now supports white and color light controls for compatible lights.
* Expanded the following control capabilities for the Node-RED **control-device** node:
* Power Percentage
* Valve Position
* Irrigation/Work-mode
* Added support for viewing Tamper Alert event logs.
### Bug Fixes
1. Resolved scene execution issues when energy consumption from devices synced via **eWeLink Smart Home Add-on** was used as a trigger.
2. Corrected battery status display when the reported battery level was 0%.
3. Fixed an issue where the thermostat control page in CAST could appear blank.
4. Fixed an issue where RTSP streams from Yoosee cameras could not be viewed on CUBE.
5. Fixed an issue where Matter Hub could repeatedly restart when removing devices added through another Matter Bridge.
6. Fixed Docker data restoration failure for backups created in versions 2.12.0 or later.
7. Fixed reverse-direction control issues affecting more than 10 third-party Zigbee curtain motor models, as well as calibration issues on some devices.
8. Fixed an issue where the SONOFF SNZB-06P24 Presence Sensor reported illuminance values too frequently.
***
## v2.13.1 - Aug. 13 2026
This release expands Zigbee and Matter Bridge compatibility, adds Dongle-PP10 support and OTA updates for the CUBE image for Mac, and improves eWeLink-linked device syncing, backups, scenes, and device stability. Please take a moment to read through the notes before updating to this version.
### What's New?
1\. **New Device Support**
* Added support for SONOFF MINI-ZB1GS single-channel Zigbee smart switch.
* Added support for SONOFF SNZB-09P Zigbee indoor siren.
* Added support for SONOFF TRV-ZBT Zigbee/Bluetooth dual-mode thermostatic radiator valve.
2\. **Expanded Zigbee Device Support**
* Added support for the following Zigbee device types:
* Water Valve
* Flow Sensor
* Rain Sensor
* Soil Sensor
* Air Purifier
3\. **Matter Bridge Enhancements**
* Added support for syncing the following Zigbee device types to Matter-enabled platforms via Matter Bridge:
* Flow Sensor
* Rain Sensor
* Soil Sensor
* Air Purifier
* Now supports syncing energy metering data from connected Zigbee devices to Matter-enabled platforms, including total energy exported and consumed.
4\. **Enhanced eWeLink-linked Device Sync Support**
* **SONOFF WS01TPE-E** Matter-over-Wi-Fi smart wall socket with energy monitoring can now be synced to eWeLink CUBE via either the eWeLink Smart Home Add-on or the built-in "Add eWeLink-linked Devices" feature.
5\. **Zigbee Dongle Enhancements**
* Added automatic detection and firmware flashing support for Dongle-PP10, including compatibility with three Zigbee firmware baud rates.
* Added support for Dongle-PP10 as a Zigbee Router, including removal and correct identification in the device list and Zigbee network topology.
6\. **System and Feature Improvements**
* Added OTA upgrade support for Mac images, allowing upgrades without re-downloading or reconfiguring while keeping device bindings and scene data.
* Added imperial gallon as a volume unit option for smart water valves.
* Downloaded backup files now use the same file names shown in the system backup list.
* Optimized scene configuration for SONOFF THR316D temperature and humidity monitoring switch, allowing temperature to be set as a scene trigger even when it's switched "off".
### Bug Fixes
1. Fixed two issues with Automatic Backups: edited schedule times were displayed incorrectly, and more than one automatic backup task could be created.
2. Fixed the confirm button remaining inactive after entering a temperature threshold for SONOFF SAWF-08P.
3. Fixed an issue where restarting CUBE could create duplicate IKEA DIRIGERA devices on Matter-enabled platforms and leave them unresponsive.
4. Fixed an issue where temperature data from SONOFF SNZB-02WD did not update after the device was synced using "**Add eWeLink-linked Devices**".
5. Fixed an issue where a SONOFF THR316D synced using "**Add eWeLink-linked Devices**" could not be used as both a trigger and an action in the same scene.
6. Fixed an issue where room assignments, accessory names, scenes, and automations for SONOFF TRVs in Apple Home could be lost after a CUBE restart.
7. Fixed an issue where backup could not be created when running CUBE in Docker environments.
8. Fixed camera stream interruptions when running CUBE in Docker on Raspberry Pi 5.
9. Fixed an issue where the measured values or statuses of some sensor devices were displayed as "unknown" or "--".
***
## v2.12.0 - Jul. 07 2026
This release expands device compatibility in CUBE OS and further improves the SONOFF TRVZB experience. Please take a moment to read through the notes before updating to this version.
### What's New?
1. **New Device Support**
* Added support for SONOFF MINI-ZB1GP / MINI-ZB1GSP single-channel Zigbee smart switches with electricity monitoring.
2. **Expanded Matter Hub Device Support**
* Matter Hub now supports the following Matter device types:
* Temperature Sensor
* Contact Sensor
* Occupancy Sensor
* Light Sensor
* Air Quality Sensor
* Smoke CO Alarm
* Generic Switch
* Dimmable Plug-in Unit
3. **Enhanced eWeLink-linked Device Sync Support**
* Eligible Zigbee sub-devices connected through SONOFF NSPanel Pro 86-Relay and Bridge-M can now be synced to eWeLink CUBE via either the eWeLink Smart Home Add-on or the built-in "Add eWeLink-linked Devices" feature.
4. **SONOFF TRVZB Enhancements**
* Optimized the temperature graph in CUBE CAST with a dynamically adjusted axis based on temperature data.
### Bug Fixes
1. Fixed an issue where a blank pop-up box was displayed when configuring temperature and humidity reporting for IKEA air quality sensors.
2. Fixed an issue where SONOFF SNZB-02M could incorrectly show air pressure comfort as out of range when no air pressure comfort range was configured.
3. Fixed an issue where the Node-RED Add-on could fail to install or update on some devices.
***
## v2.11.0 - Jun. 16 2026
This release expands compatibility for multiple SONOFF devices and support for Matter Bridge camera capabilities, with improved room temperature sensing for SONOFF TRVZB. Please take a moment to read through the notes before updating to this version.
### What's New?
1. **New Device Support**
* Added support for the following SONOFF devices:
* SONOFF SNZB-06P24 24GHz presence sensor.
* SONOFF SNZB-03PR2 motion sensor with illuminance reporting.
* SONOFF SWV-ZF2U / SWV-ZF2E dual-channel smart water valve.
* SONOFF BASIC-ZB1GSP smart plug with energy monitoring.
2. **Matter Bridge Camera Support**
* Syncing eligible cameras to the added Matter platforms via Matter Bridge is now available, with video and audio streaming.
3. **SONOFF TRVZB Enhancements**
* SONOFF SNZB-02B can now be used as an external sensor for SONOFF TRVZB, providing more accurate room temperature readings.
### Bug Fixes
1. Fixed an issue where the energy consumption graph failed to load for Zigbee plugs synced to CUBE via eWeLink Smart Home Add-on.
2. Fixed an issue where SONOFF Zigbee Dongles could not be detected or configured properly by CUBE when connected to Raspberry Pi 4.
***
## v2.10.3 - May 27 2026
This release introduces built-in eWeLink Smart Home for easier device syncing, One-click Installation on Mac, and adds support for running CUBE OS in Docker environments for more flexible deployment options. Please take a moment to read through the notes before updating to this version.
### What's New?
1. **Built-in eWeLink Smart Home for Easier Device Sync**
* A simpler way to sync eWeLink-linked devices is now available in CUBE. Sign in with your eWeLink account from **Home > Add Device** to sync and manage eligible devices directly in CUBE, without installing the eWeLink Smart Home Add-on.\
*Note: Existing add-on devices will continue to work independently.*
2. **Docker Deployment Support**
* CUBE OS can now run in Docker environments, giving users more flexible deployment options.\
For Docker-based deployments, the following system-level features are not available:
* Docker (Add-ons)
* Pilot Features > Bluetooth Speaker
* Settings > Gateway Info > Version Update
* Settings > Reboot & Shutdown
* To update a Docker-based deployment, pull the latest Docker image.
3. **Expanded One-click Installation Support**
* Added support for one-click installation of CUBE on Mac.
***
## v2.10.2 - May 18 2026
This release introduces SONOFF Dongle firmware management, expanded deployment options, and new device support, while further improving Matter Bridge compatibility, Zigbee device behavior, and overall system stability. Please take a moment to read through the notes before updating to this version.
### **What's New？**
1. **SONOFF Dongle Firmware Management**
* Added automatic detection for connected Zigbee Dongles. Unsupported SONOFF Dongles can now be upgraded to recommended stable Zigbee firmware versions with one click:
* Ember-based Dongles with firmware versions earlier than v7.4.5 will be upgraded to v8.0.2.
* ZStack-based Dongles with firmware versions earlier than v20250321 will be upgraded to v20250321.
* After upgrading CUBE to v2.10.2, connected SONOFF Dongles will be automatically upgraded to the recommended stable firmware versions. Non-SONOFF Dongles must be upgraded using their official flashing tools to ensure proper connection and device control.
* Optimized Zigbee offline detection behavior:
* Router devices report within 1 minute
* End devices report within 1 hour
* Devices exceeding the reporting interval will appear offline until triggered again.
2. **Expanded Deployment Support**
* Added support for one-click installation of CUBE on Windows.
3. **Matter Bridge Enhancements**
* Upgraded the CUBE Matter Bridge SDK to v1.5.0.
* Optimized the default device naming when syncing devices to SmartThings and Alexa via Matter Bridge.
4. **SONOFF TRVZB Enhancements**
* Added Adaptive Mode for SONOFF TRVZB, configurable in the eWeLink App, to help maintain a more stable room temperature.
5. **New Device Support**
* Added support for SONOFF Hydro ONE Zigbee Smart Water Valves (SWV-ZFU / SWV-ZFE) and SONOFF Hydro ONE Lite Zigbee Smart Water Valves (SWV-ZNU / SWV-ZNE).
* Added support for SONOFF MINI-ZBD Smart Dry Contact Module.
6. **Zigbee Device Compatibility Improvements**
* Optimized power-on behavior configuration for third-party Zigbee devices.
7. **Shutdown Feature**
* Added a shutdown option in the CUBE Web settings page.
### **Bug Fixes**
1. Fixed an issue where Raspberry Pi 5 Rev1.1 boards could fail to boot properly.
2. Fixed an issue where devices could fail to sync to Alexa via Matter Bridge.
3. Fixed timeout issues when adding ONVIF / RTSP cameras.
4. Fixed the issue where the status of the HOBEIAN ZG-102ZM vibration sensor did not update.
5. Fixed the issue where the historical data chart of Zigbee plugs was not displayed.
***
## v2.9.0 - Feb. 13 2026
This release expands eWeLink Smart Home Add-on compatibility and device support, with notable improvements to Zigbee reliability, automation stability, and device control flexibility. Please take a moment to read through the notes before updating to this version.
### **What's New?**
1. **Expanded eWeLink Smart Home Add-on Device Support**
* Added support for syncing eligible air quality monitors to CUBE via eWeLink Smart Home Add-on, including:
* **SONOFF SAWF-07P**
* **SONOFF SAWF-08P**
* Added support for SONOFF SNZB-04PR2 Door/Window Sensor.
2. **Sensor Accuracy & Calibration Enhancements**
* Added an option to adjust temperature and humidity offsets for **SONOFF SNZB-02P** to improve reading accuracy.
3. **SONOFF TRVZB Enhancements**
* Boost Mode and Temp. Override Mode can now be enabled or disabled directly from **CUBE CAST.**
* **SONOFF SNZB-02LD** can now be used as an external sensor for more accurate room temperature and humidity measurements.
4. **Zigbee Reliability Improvements**
* Optimized Zigbee offline detection logic to identify device disconnections faster and improve overall control reliability. (Note: Due to reporting interval limitations, legacy **SNZB-01 / SNZB-02 / SNZB-03 / SNZB-04** sensors are excluded from this optimization)
5. **Device Control & Calibration Enhancements**
* Added an option to configure extra travel time for **SONOFF MINI-ZBRBS** to ensure blinds fully open and close during manual calibration.
* Added stepping control support for **SONOFF MINI-ZB2GS**, allowing external switch presses to cycle through predefined relay states for more flexible multi-state control scenarios.
* Added a manual calibration option to **SONOFF MINI-ZBDIM** dimming calibration.
### **Bug Fixes**
1. Fixed a bug where input capability of **Frient IOMZB-110** module was missing in eWeLink CUBE.
2. Resolved a control issue with **Tuya/Moes AM43-0.45/40-ES-EZ** curtain motor.
3. Fixed an issue where **Paulmann Gen2 RGB Remote** could not be used as a scene trigger.
4. Corrected an issue where the **SONOFF R5 remote** did not trigger automations as expected after restoring from a backup.
5. Fixed an issue where scenes had to be re-enabled after an eWeLink CUBE reboot to run again.
6. Fixed an intermittent issue where the **Matter Bridge** could become unresponsive on third-party platforms when synchronizing a large number of devices.
7. Optimized the logic for synchronizing water leak sensors via the **Matter Bridge**.
***
## v2.8.1 - Nov. 27 2025
We're excited to announce that **CUBE OS has now transitioned from beta to its official release version**. From this version onward, **CUBE OS version numbers will stay aligned with iHost releases** for consistent updates and feature improvements.
This update expands Matter Bridge and eWeLink Smart Home Add-on support, introduces new features for SONOFF TRVZB, enhances scene organization, and improves overall usability. Please take a moment to read through the notes before updating to this version.
### What's New?
1. **Expanded Matter Bridge Device Support**
* Added support for syncing additional Matter-defined device types via Matter Bridge, including:
* Light Sensor
* Smoke & CO Alarm (covering smoke and carbon monoxide sensors)
* Air Quality Sensor
* Room Air-conditioner
* Fan
2. **New Features for SONOFF TRVZB**
* Added two new temporary modes for SONOFF TRVZB:
* Boost Mode: heats the room quickly for a short period.
* Temp. Override Mode: temporarily maintains a set temperature.
3. **Scene Enhancements**
* Easily create custom labels and assign scenes to existing labels.
4. **New features for ONVIF compatible Cameras**
* ONVIF-compatible cameras now support using "Motion Detected" and "Occupancy Detected" as scene triggers.
5. **Expanded eWeLink Smart Home Add-on**
* Added support for syncing eligible devices to CUBE via eWeLink Smart Home Add-on, including:
* SONOFF Mini-RBS
* Virtual Devices (covering switches and buttons)
* Sub-devices from ZBBridge-U: SONOFF S60ZB, SNZB-02LD/SNZB-02WD, Mini-ZBRBS, SWV
6. **Device List Enhancements**
* You can now hide offline devices from the Home page device list for a cleaner, more focused view.
7. **Data Visualization Enhancements**
* Temperature and humidity graphs now support minute-level data for more detailed insights.
### Bug Fixes
1. Fixed an issue where scene notifications were not received via CUBE CAST during remote access.
2. Fixed compatibility issues with Tuya TS0001 Fingerbot.
3. Fixed Matter Bridge issues:
* Fixed an issue where the Matter Bridge repeatedly went offline.
* Fixed a problem where adding more than 10 devices prevented newly added devices from being synchronized through Matter Bridge.
* Fixed an issue where the Matter Fabric displayed as empty.
* Fixed an issue where deleting a device from CUBE did not correctly remove the corresponding device from the third-party Matter platform.
4. Fixed SONOFF TRVZB issues:
* Fixed an issue where Boost Mode and Temp. Override Mode failed to execute correctly.
* Fixed an issue where scene actions incorrectly allowed selecting Temp. Override Mode.
* Fixed an issue where adjusting the Boost Time while in Boost Mode caused inconsistent or incorrect timing.
* Fixed a bug where minute-level data of temperature and humidity graphs could not be properly displayed.
* Fixed an issue where the target temperature displayed in CAST exceeded the allowed range.
* Fixed an issue where the TRV's target temperature for Boost/Temp. Override Mode could not be synchronized or displayed correctly.
***
## v0.5 - Aug. 27 2025
This update brings extended Zigbee dongle compatibility, ONVIF camera enhancements, and notable improvements for CUBE CAST. Please take a moment to read through the notes before updating to this version.
### What's New?
1. **Expanded Zigbee Dongle Compatibility**
* Added support for SONOFF ZBDongle-P and SMLIGHT SLZB-06 Zigbee Coordinator.
* Currently tested and verified compatible dongles:
* SONOFF ZBDongle-E / P
* SMLIGHT SLZB-06 / 06M
* SkyConnect Zigbee (EZSP)
2. **ONVIF Camera Support**
* Added automatic discovery of ONVIF-compatible cameras.
* Supported PTZ (Pan-Tilt-Zoom) control.
* Tested and verified compatible devices (with required firmware versions):
* SONOFF CAM-PT2: FW ≥ 1.0.6
* SONOFF CAM-B1P: FW ≥ 1.0.2
3. **CAST Enhancements**
* Extended CAST pad layouts for a more flexible dashboard experience.
### Bug Fixes
1. Fixed an issue where CUBE OS failed to boot on Raspberry Pi 5 and could not perform OTA updates.
2. Corrected inaccurate data display in thermostatic radiator valves' trend graphs.
3. Fixed a bug where scenes triggered by power thresholds failed to execute properly.
4. Fixed an issue where device status updates on CAST required a manual browser refresh.
***
## v0.4 - Jun. 19 2025
### What’s New?
1. Standalone installation support for:
* Raspberry Pi 4B / 5
* -x86\_64 Virtual Machines (e.g., VirtualBox, VMware)
* NAS devices (compatible models)
2. Zigbee device support via USB dongles (e.g., SONOFF ZBDongle-E)
3. Matter Hub & Matter Bridge
4. Remote Access/Push Notifications via PWA
5. Docker & Add-ons support
6. Scenes, Groups, OTA, CAST Dashboards, and more\
For more details:\
### How to Try
1. Download the image that fits your environment (Raspberry Pi / VM / NAS)\
`raspberrypi4_64_prod.img.xz` for Raspberry Pi\
`sdcard.vdi.xz/sdcard.vmdk.xz` for VMs, NAS devices
2. Flash and install by following these guides:\
3. Join our [Discord server](https://discord.gg/67Ybdn23rS) to get support and share feedback
***
## v0.2 - Dec. 31, 2024
### What’s New?
* Remote Access rolls out for Pilot Features. When enabled, it allows remote access to CubeOS' web console and CAST via secured links.
* CAST can be installed as a web app with remote links. The app enables notifications for scene executions, Smart Security events, switch and plug toggles, and sensor triggers, including:
* Motion detection
* Presence detection
* Open window detection
* Gas detection
* Water leakage detection
* Smoke detection
* Press actions
* Users can now change the password for the web console.
* A new MQTT Broker settings page is available, supporting adding accounts and passwords. It allows connection to the broker using those credentials to subscribe to MQTT messages.
* Cameras now support simultaneous viewing of multiple streams.
**New Platform:**
* Raspberry Pi 5 (unverified).
**Optimizations:**
* Optimized the Tasmota add-on by using the built-in Mosquitto broker, retiring the need for extra broker installation.
* Improved the display format of Matter setup codes for better readability.
**Bug Fixes:**
* Resolved an issue where version 0.1 could not handle updates via OTA.
**Known Issues:**
The following known issues exist with version 0.2 and remain to be fixed in future updates:
* When accessing the web for the first time, virtual machines and Raspberry Pi might occasionally show a disconnection prompt.
* Raspberry Pi installation does not support adding fresh new or factory resetting Matter devices. Please use alternative Matter platforms and share them with CubeOS.
* Matter Hub sometimes crashes and restarts continuously.
* Remote notifications are unstable; users may not receive system pushes, potentially related to the network environment, browser issues, or backend process closures.
* Camera streaming may fail for Raspberry Pi installation via remote links.
* Matter Bridges won't show sub-devices on the devices' control page. And for sub-devices connected to a Matter Bridge on the settings page, the information of the Connected Bridge is missing.
* Matter fabric with Vendor ID "1286" can not be removed on CubeOS. If the system promotes a device that is full of fabric, please remove one from the other Matter platforms it is connected to.
* OTA is unsupported for Raspberry Pi 5 installation.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://cube.ewelink.cc/resources/change-log.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.