Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

Emerald Hot Water System is an integration that connects Emerald hot water heaters to Home Assistant through the vendor's cloud. It adds water heater entities and sensors, and it is configured in the UI with the Emerald account username and password. Options cover how long a connection is kept before reconnecting and the maximum time between data updates before the connection counts as unhealthy. An optional setting creates energy usage sensors that show cumulative kWh for the current day and reset at midnight, so they can be used in the Energy dashboard. Emerald only provides hourly energy data. If Emerald rejects the saved credentials, a notice appears in Settings under Repairs.

Automatic summary of the README and code of ross-w/emerald-hws-ha. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

  • Uses the vendor's cloud Needs an internet connection and an account with the vendor.

  • From the Marketplace Installed through the Marketplace, formerly HACS.

  • Actively maintained Its author released or pushed a change in the last six months.

Provides

  • Water heaters
  • Sensors

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Connect

  • Password for Emerald app
  • Username for Emerald app
  • Connection timeout in minutes (default: 720)
  • Health check interval in minutes (default: 60)
  • Create energy usage sensors

Also asked when changing the connection.

Texts from the code of ross-w/emerald-hws-ha.

Troubleshooting

  • Repair noticesNotices it can show in Settings, Repairs:Emerald rejected the saved credentials

From the README

This integration will set up the following platforms.

From the README of ross-w/emerald-hws-ha, MIT License. Shortened.

Shows in Vulpo

Chart card, Apple Watch.

Information

Installs
62 sharing analytics
GitHub stars
15
Connection
Uses the vendor's cloud
Upkeep
Updated in the last 6 months
Version
1.1.8,
Category
Climate, Water heaters
Kind
Marketplace integration
Needs
Needs the Marketplace (HACS on 2026.10 and older)
Domain
emeraldenergy

You might also like

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. About these numbers