# Hydroqc2mqtt

Hydroqc2mqtt is a Docker container that fetches Hydro-Québec account, billing, and winter credit data and exposes it to Home Assistant. It is open source and self-hosted, installable on Proxmox, Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2911/hydroqc2mqtt

## Description

Hydroqc2mqtt is a Docker container that fetches Hydro-Québec account, billing, and winter credit data and exposes it to Home Assistant. It publishes MQTT topics and Home Assistant discovery messages so the relevant sensors are created automatically, and it streams hourly consumption statistics to Home Assistant over a WebSocket connection. It is useful for homelab users who want their Quebec electricity usage, billing, and winter credit status available as sensors.

## Platform availability

Available on 2 of 10 platforms: Unraid, Proxmox.

## Health score

8/100 (Low), based on 3 of 4 factors.
- Maintained: 0 (last commit 1071 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=hydroqc2mqtt
- Official website: https://hydroqc.ca/
- GitHub: https://github.com/XaF/docker-hydroqc2mqtt
- Docker Hub: https://hub.docker.com/r/thexaf/hydroqc2mqtt
- Unraid: https://ca.unraid.net/apps/hydroqc2mqtt-0us76bg0g8s428?q=hydroqc2mqtt

## Common questions

### Do the Docker installation examples always reflect current settings?

No. The official installation docs say examples may be out of date, so check the Configuration section for valid settings and edit the environment variables in the docker run command.

### What should I check if hydroqc2mqtt cannot fetch Hydro-Québec data?

Check that you can access your Hydro-Québec customer portal with your account, enable debugging, and post the information on Discord #support or open an issue.

### Does hydroqc2mqtt require an MQTT server?

Yes. The GitLab project describes it as an MQTT daemon that sends Hydro-Quebec account information to your MQTT server for Home-Assistant or other home automation platforms.

### Are ARM containers built for hydroqc2mqtt?

The GitHub repository describes a Docker builder for ARM that builds the container and pushes it to the hydroqc2mqtt tags on Docker Hub.

---
Source: Our Local Host (https://ourlocalhost.com/app/2911/hydroqc2mqtt), the self-hosted and open-source app directory.
