Skip to main content

SMHUB-OS release notes

TO BE RELEASED 12 OCT 2025 SUNDAY

smhub-os v0.2.2 + 
smhub-service 0.1.7-1+
smhub-web v0.2.3-1 (2025-10-12)

Today’s release marks a big step forward in the SMHUB platform — a major shift in how updates are delivered and managed.
While the visible feature list may seem short, this release is fundamentally important: it establishes the core OTA infrastructure that will power all future SMHUB updates.

From now on, SMHUB updates will happen entirely via the web interface, without the need for Type-C flashing or manual intervention.


🧩 SMHUB System Architecture

SMHUB is built as a modular software stack with three key subsystems working together:

Subsystem Description
smhub-os Core Linux system — provides the kernel, drivers, and low-level environment.
smhub-services Backend layer handling configuration, networking, and communication between OS and the web interface.
smhub-web Front-end web interface for interacting with the device, viewing system state, and adjusting settings.

This modular structure enables safe, incremental updates and future scalability — we can now push new kernel, backend, or UI updates independently.


🆕 Latest Versions (as of 12 Oct 2025)

Component Version Description
smhub-os 0.2.2 Updated kernel and file system with full OTA kernel flashing support.
smhub-services 0.1.7-1 Improved backend management of configuration and processes.
smhub-web 0.2.3-1 Updated UI with new dashboard and refined settings layout.

🔧 What’s New

  1. Full Kernel OTA Support
    The Linux kernel and base OS can now be updated directly from the web interface — no Type-C connection required.

  2. 🌀 Z-Wave JS Boot Fix
    Fixed an issue that prevented Z-Wave JS from starting automatically at boot.

  3. 🧾 New Application Log Viewer
    Many apps (including Zigbee2MQTT) now include a Logs tab directly in the Web UI.
    To view logs: open the app page → click Logs → logs will appear in real time.
  4. 🏠 Updated Dashboard Notes
    Added helpful contextual information about the current development stage and upcoming feature rollout.

  5. 🔒 Unavailable Settings Pages Refinement
    Incomplete or not-yet-implemented settings pages are now visually blocked for a clearer experience.

  6. 🆔 Firmware Version Display
    Firmware version is now visible in the bottom-left corner of the web interface.

  7. 💻 (Coming Soon) Web Console 
    We’re working on enabling direct Linux console access from the web interface under
    Settings → Console. This will allow executing shell commands right from UI.

⚙️ Required Update Sequence

Before updating to SMHUB OS 0.2.2, please follow this exact sequence:

  1. If you are running SMHUB-OS 0.2.1c - go to step 5. Otherwise, please update your SMHUB to SMHUB-OS v0.2.1c per this manual: https://smlight.tech/support/manuals/books/smhub/page/smhub-early-adopter-quick-start-guide#bkmrk-updating-smhub-firmw 

  2. Reboot the device, wait until Green Ambilight LEDs are on.

  3. Go to the device UI by accessing http://smhub.local/ 
  4. Go to "Apps" update both apps:

    • smhub-services to the latest (0.1.7-1)

    • smhub-web to the latest (0.2.3-1)

  5. If you do not see the updated app, please do a one-off command sudo opkg update) via SSH access. (Here is a manual hot to access the console of the SMHUB https://smlight.tech/support/manuals/books/smhub/page/smhub-early-adopter-quick-start-guide#bkmrk-note-1)
  6. Once all updates are applied, open “Settings → Update and Backup” again - OS 0.2.2 will appear there as the next available update. Please click "Update" and Reboot after successful flashing

Following this sequence ensures that the new OTA kernel update mechanism installs correctly.


⚙️ Why This Release Matters

This update may not look flashy, but it’s a core infrastructure milestone.
Until now, OTA covered only the web interface and backend — now, the entire OS stack (including kernel) can be updated seamlessly.

Our recent focus has been on building a reliable OTA foundation.
With that in place, the next releases will shift toward new features, integrations, and automation capabilities, all distributed via this new update system.