Troubleshooting

General troubleshooting steps

  1. Check that you can access the Hydro-Québec customer portal with your account.

  2. Check the Known Issues.

  3. Enable debug logging for the integration in your configuration.yaml:

    logger:
      default: info
      logs:
        custom_components.hydroqc: debug
        custom_components.hydroqc.config_flow.base: debug
        custom_components.hydroqc.coordinator.base: debug
    
  4. Post the information on Discord #support or open an issue for hydroqc-ha.

Common problems

Connection failed

  • Verify your credentials on the Hydro-Québec website
  • Check for special characters in your password
  • Make sure the account has active contracts

No data appearing

  • Wait 60 seconds for the first update
  • Check the Home Assistant logs: Settings > System > Logs
  • Verify the Hydro-Québec portal is online

Sensors unavailable

  • Some sensors are only active during specific seasons (winter credits)
  • Verify that your rate plan supports the sensor
  • For peak sensors, verify that a calendar is configured and contains the expected events
  • Check that the coordinator is updating (check the logs)

Known Issues

Issues we are aware of and their workarounds.

Obtaining your account information

How to get information from your account to help us integrate new account types or features

Diagnostic tool

Extraction of account data with the diagnostic tool.