Skip to main content

SMHUB-OS release notes

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. Go to the terminal SSH (details here) and execute two commands:

    • sudo opkg update

    • sudo opkg upgrade

  3. Go to "Apps" and verify that both apps are updated to:

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

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

  4. 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
  5. Please note, later, to update, one more (and only one) time you will need to to SSH command. All the further updates will be available via buttons in the UI.

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.

⚙️ I did an update of smhub-services to 
0.1.7-1 via UI button, but my device hangs/freezes

If you do update of smhub-services via the web-interface button rather than via SSH commands as described here, your device will hand.

To unfreeze it, please execute step 2, namely these commands:

  1. Go to the terminal SSH (details here) and execute two commands:

    • sudo opkg update

    • sudo opkg upgrade

Back to top