Balboa Spa
homebridge-balboa-spa · v3.0.1
Adds Balboa Wi-Fi spas and hot tubs to HomeKit with pumps, lights, blower and thermostat.
What it says it supports
Brands
- Balboa
Devices it names
- Balboa BWA Wi-Fi module spas
Shows up in Apple Home as from its README
Sensor readings in its code
What people report
Works with older Balboa spa WiFi modules and RS485-to-IP bridges; newer Gateway Ultra hardware is unsupported.
- Partly works1
- Won’t be supported1
| Device | Status | What they said | Source |
|---|---|---|---|
| Elfin EW11A RS485-to-IP bridge with Balboa spa | Partly works | Controls the spa but logged many unrecognized messages; beta logs each onceSaved copyHi! First of all, many thanks for this plugin. I tried https://github.com/jshank/bwalink with bwa installed on my raspberry and nothing worked. Im using 24$ Elfin-EW11A-0 in 115200,8N1 settings and with your plugin Im able to control my spa. But plugin produce lots of fault messages. Do you have any idea what can I do? Maybe I need to do more setup on elfin but dont know exactly what to change. Any idea? Many thanks again!!! Its working almost out of the box!!! Im attaching homebridge log and elfin settings. homebridge.log-4.txt Excerpt saved from GitHub on 2026-10-22. | Issue #21 · 2022-07 |
| Balboa Gateway Ultra WiFi module (59304-H) | Won’t be supported | Newer hardware uses a different control protocol; documented as unsupportedSaved copyUnfortunately, there's no easy solution to this that I am aware of. It seems as if this (new?) set of hardware (Gateway Ultra, etc) from Balboa is completely different, and in particular uses a different approach for control messaging. There is this: https://gitlab.com/VVlasy/controlmyspajs . This would appear to be an open-source controller that works and might work for you - but everything does a round-trip into Balboa's cloud, which is rather sad (and presumably imposes some unnecessary latency at best). And of course it is not integrated into HomeKit, homebridge, etc at all. If there is a … Excerpt saved from GitHub on 2026-10-22. | Issue #17 · 2021-11 |
Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local
Balboa Wi-Fi module on LAN, auto-discovered
You’ll need
- Homebridge 2.0.0
- Node 22/24/26
Compatibility
| Verified by Homebridge | Yes |
|---|---|
| Homebridge versions | >=2.0.0-beta.100 |
| Homebridge 2.0 | Yes |
| Node.js | ^22 || ^24 |
| Settings in Homebridge UI | Yes |
| Matter | Yes (uses the Homebridge 2 Matter API) |
| Platform name | Balboa-Spa |
| License | Apache-2.0 |
Community signals
| Downloads a week | 17 |
|---|---|
| Downloads a month | 178 |
| GitHub stars | 21 |
| Open issues | 7 |
| Closed issues | 19 |
| Last code push | 2026-09-13 |
| Latest version | 3.0.1 (2026-04-28) |
| First published | 2020-05-12 |
| Releases | 150 |
In ReReHome
Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.
Bridges get their own settings page listing the accessories behind them.
Caveats from the README
- Wi-Fi module allows one connection, so BWA app cannot be used simultaneously
- Lights on/off only, no color
- Not for ControlMySpa cloud spas
- Swim spas and Clim8zone unsupported
HomeKit services in its code
Found by scanning the published npm package. A plugin can register a service only for some devices.
- Fan
- LeakSensor
- Lightbulb
- LockMechanism
- Switch
- TemperatureSensor
- Thermostat
