homebridge-rinnai-controlr2

Homebridge plugin for Rinnai tankless water heaters using the current Rinnai Control-R 2.0 API.

The original homebridge-rinnai-controlr plugin stopped working in 2023 when Rinnai changed their authentication. This plugin uses the updated Cognito auth and GraphQL API that the Rinnai 2.0 app currently uses.

Features

• Temperature control — Set your water heater temperature from HomeKit (100–140°F)
• On/Off — Turn your water heater on and off
• Recirculation — Toggle recirculation with configurable duration
• Auto-discovery — Finds all water heaters on your Rinnai account
• Live status — Polls current temperature, heating state, and recirculation status every 60 seconds

Requirements

• Rinnai tankless water heater with the Control-R WiFi module
• Rinnai Control-R 2.0 app with an active account (must be migrated from the old app)
• Latest Control-R firmware
• Homebridge >= 1.6.0

Installation

Via Homebridge Config UI X (recommended)

Search for homebridge-rinnai-controlr2 in the Homebridge plugin search and click Install.

Via command line

npm install -g homebridge-rinnai-controlr2

Configuration

Via Config UI X

After installing, go to the plugin settings and enter your Rinnai app email and password. All other settings have sensible defaults.

Manual configuration

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

{
    "platform": "RinnaiControlR2",
    "name": "Rinnai",
    "username": "[email protected]",
    "password": "your-rinnai-password",
    "recirculationDuration": 15,
    "minimumTemperature": 110,
    "maximumTemperature": 140
}

| Parameter | Required | Default | Description | |-----------|----------|---------|-------------| | username | Yes | — | Your Rinnai Control-R 2.0 app email | | password | Yes | — | Your Rinnai Control-R 2.0 app password | | recirculationDuration | No | 15 | Minutes to run recirculation (1–60) | | minimumTemperature | No | 110 | Min temperature in °F (100–140) | | maximumTemperature | No | 140 | Max temperature in °F (100–140) |

HomeKit Accessories

The plugin creates two accessories per water heater:

• Thermostat — Shows current water temperature, lets you set target temperature and turn the heater on/off
• Recirculation Switch — Toggle to start/stop recirculation

Tested Models

• Rinnai RUR199iN
• Rinnai RUR160iN

Should work with any Rinnai tankless water heater that supports the Control-R 2.0 app and WiFi module.

Troubleshooting

"User not found" error — Make sure you're using the email and password from the Rinnai Control-R 2.0 app (not the old app).

"Incorrect username or password" — Double-check credentials. If your password has special characters, try updating it to use only letters and numbers.

No devices found — Make sure your water heater appears in the Rinnai Control-R 2.0 app and the WiFi module is connected.

Credits

API constants derived from the aiorinnai Python library by explosivo22.

License

MIT