Home Assistant: Bristol Water

Published in Home Automation, Python on Jun 6, 2025

Since the start of 2024, I have been using the REST integration for bringing Bristol Water quality data into my Home Assistant dashboard.

I've recently wanted to migrate that to a custom integration for testability and to practice my Python skills again.

Installation

Using HACS (recommended):

Add the custom repository: https://github.com/owenvoke/hass-bristol-water
Search for the integration "Bristol Water" and install it

Manual installation:

Download https://github.com/owenvoke/hass-bristol-water/archive/main.zip
Extract the custom_components/bristol_water directory to your installation

Further steps for both variants:

On the integrations page, add the “Bristol Water” integration in the UI.
The integration only requires your postcode.

Code

The code for the integration is available on GitHub: https://github.com/owenvoke/hass-bristol-water

Reporting Bugs

If something doesn’t work, please provide any log details that occur. To do so, enable debug logging for the Oh Dear integration. This can be done via the integration in Home Assistant, or via the configuration YAML:

logger:
  default: warning
  logs:
    custom_components.bristol_water: debug

An issue should then be opened on the GitHub repository.

Notes

This integration pairs nicely with the card examples from my previous blog post.