[App] Nibe S-Series MQTT Bridge — local REST API, no cloud, ~1000 entities

Share your Projects!
, , , ,
1

Hi everyone,

I’ve been running a Nibe SMO S40 with an S2125 heat pump and wanted proper local integration in Home Assistant — no Nibe myUplink cloud account, no polling through their servers, no hardcoded register maps. The result is the Nibe S-Series MQTT Bridge: a HA add-on that uses Nibe’s built-in local REST API to expose everything the controller reports as native HA entities via MQTT auto-discovery.

What it does:

  • Discovers all available data points automatically — no register maps to maintain, no YAML configuration of individual entities
  • Creates 900–1,200 native HA entities on a typical installation (sensors, switches, numbers, selects, binary sensors)
  • Bidirectional — read sensor values and write settings back to the controller
  • Mode-based entity management: start with essential (~100 entities) and expand as you explore
  • Active alarm monitoring — faults appear in HA within 10 seconds
  • Provisions a Nibe Menus Lovelace dashboard mirroring the full installer menu structure
  • Companion Entity Manager card with search, filtering, and per-entity firmware metadata
  • Fully local — no cloud, no Nibe myUplink account required

Compatible hardware:

Any Nibe S-series controller running firmware 4.5.7 or later with the local REST API enabled (Menu 7.5.15): SMO S40, VVM S320/S325/S500, S1155/S1255/S1156/S1256, S735. Accessories on the internal bus appear automatically.

Not compatible: older Nibe controllers (SMO 20, SMO 40) and F-series indoor units — those use a different architecture with no REST API.

Installation:

  1. In Home Assistant go to Settings → Apps → Install app → ⋮ → Repositories and add:
    https://github.com/whatsinabyte/nibe-smo-mqtt-bridge
  2. Install the Nibe S-Series MQTT Bridge app
  3. Enable the local API on your controller — Menu 7.5.15 on all S-series products
  4. Configure the app with your controller’s IP address and API credentials
  5. Start the app

Full documentation: https://github.com/whatsinabyte/nibe-smo-mqtt-bridge

Still marked experimental — tested on SMO S40 + S2125 on firmware 4.12.6. Feedback from other S-series hardware very welcome.

2

Suggestion:
Add-ons have been renamed to Apps about a year ago now.

Add-ons no longer exist and building new Apps and using the words and links to the old way in the readme is very confusing for users wanting to try your stuff…

Please consider a wording revision.
A simpler approach may be to use the Create a link – My Home Assistant facility…

For instance, this install sequence from your readme doesn’t work:

Proofreading and testing the actual instructions that you copied from other sources to make sure things are right is a good best practice to follow. So is this: AI Policy | Home Assistant Developer Docs

3

Thanks for the heads-up — good catch. I’ve updated all documentation to use “app” and “App Store” throughout, and corrected the installation navigation path. Appreciate the feedback.

On the My Home Assistant deep link — I tried it but it’s currently not pre-filling the repository URL due to a known bug (# Bug: supervisor_add_addon_repository redirect does not open pre-filled add repository dialog · Issue #698 · home-assistant/my.home-assistant.io · GitHub). Using the manual navigation path for now until that’s resolved.