# Change Log ## 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.\ \&#xNAN;*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: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://cube.ewelink.cc/resources/change-log.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.