Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Change Log

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.

  1. 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

  1. 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.

  1. 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.

  1. Matter Bridge Camera Support

  • Syncing eligible cameras to the added Matter platforms via Matter Bridge is now available, with video and audio streaming.

  1. 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.

  1. 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.

  1. 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.

  1. Expanded Deployment Support

  • Added support for one-click installation of CUBE on Windows.

  1. 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.

  1. SONOFF TRVZB Enhancements

  • Added Adaptive Mode for SONOFF TRVZB, configurable in the eWeLink App, to help maintain a more stable room temperature.

  1. 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.

  1. Zigbee Device Compatibility Improvements

  • Optimized power-on behavior configuration for third-party Zigbee devices.

  1. 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.

  1. Sensor Accuracy & Calibration Enhancements

  • Added an option to adjust temperature and humidity offsets for SONOFF SNZB-02P to improve reading accuracy.

  1. 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.

  1. 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)

  1. 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

  1. 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.

  1. Scene Enhancements

  • Easily create custom labels and assign scenes to existing labels.

  1. New features for ONVIF compatible Cameras

  • ONVIF-compatible cameras now support using "Motion Detected" and "Occupancy Detected" as scene triggers.

  1. 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

  1. Device List Enhancements

  • You can now hide offline devices from the Home page device list for a cleaner, more focused view.

  1. 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.

  1. 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)

  1. 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

  1. 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)

  1. Zigbee device support via USB dongles (e.g., SONOFF ZBDongle-E)

  2. Matter Hub & Matter Bridge

  3. Remote Access/Push Notifications via PWA

  4. Docker & Add-ons support

  5. Scenes, Groups, OTA, CAST Dashboards, and more For more details: https://forum.ewelink.cc/t/ewelink-cube-os-v0-4-beta-self-hosted-ewelink-server-public-testing-now-open/198406

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: https://github.com/eWeLinkCUBE/CUBE-OS/tree/master/Installation%20%26%20User%20Guide

  3. Join our Discord server 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.

PreviousZigbee
NextDeveloper & API Guide

Last updated