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.
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- Issues
- Report an issue











