homebridge-huum-sauna2

Homebridge plugin for HUUM sauna heaters. Control your sauna from Apple HomeKit.

Features

• On/Off — Turn the sauna heater on and off from HomeKit
• Temperature control — Set target temperature (40–110°C)
• Current temperature — Monitor real-time sauna temperature
• Heating status — See whether the sauna is actively heating or idle
• Door safety — Refuses to start the heater if the sauna door is open (same behavior as the HUUM app)

Requirements

• HUUM sauna heater with the UKU WiFi controller
• HUUM app account with a connected sauna
• Homebridge >= 1.6.0

Installation

Via Homebridge Config UI X (recommended)

Search for homebridge-huum-sauna2 in the Homebridge plugin search and click Install.

Via command line

npm install -g homebridge-huum-sauna2

Configuration

Via Config UI X

After installing, go to the plugin settings and enter your HUUM app email and password.

Manual configuration

Add to the accessories array in your Homebridge config.json:

{
    "accessory": "HuumSauna",
    "name": "Sauna",
    "username": "[email protected]",
    "password": "your-huum-password",
    "pollInterval": 60,
    "defaultTemp": 80,
    "minTemp": 40,
    "maxTemp": 100
}

| Parameter | Required | Default | Description | |-----------|----------|---------|-------------| | username | Yes | — | Your HUUM app email | | password | Yes | — | Your HUUM app password | | pollInterval | No | 60 | Polling interval in seconds (10–600) | | defaultTemp | No | 80 | Default target temp in °C (40–110) | | minTemp | No | 40 | Minimum temp in °C | | maxTemp | No | 100 | Maximum temp in °C |

How It Works

The plugin uses the HUUM cloud API (api.huum.eu) with basic authentication — the same credentials you use in the HUUM app. It polls the sauna status at the configured interval and pushes updates to HomeKit.

The sauna appears as a Thermostat accessory in HomeKit with Heat and Off modes.

HUUM API Status Codes

• 230 — Sauna offline
• 231 — Sauna online and heating
• 232 — Sauna online, not heating
• 233 — Sauna in use by another user

Troubleshooting

Sauna won't turn on — Check that the sauna door is closed. The plugin enforces the same door safety check as the HUUM app.

"Poll failed" errors — Verify your HUUM credentials are correct and that you can log into the HUUM app.

Temperature not updating — The plugin polls at the configured interval (default 60 seconds). Decrease pollInterval for faster updates.

License

MIT