Skip to content

Troubleshooting

Practical solutions for the most common problems encountered when running Hanergy.

Quick Diagnostic Checklist

Before diving into specific pages, work through this checklist:

  1. Is Hanergy running? Check Settings > Add-ons > Hanergy. The add-on should show "Started".
  2. Is the connection active? The dashboard should show "Connected" for the HA connection. If it shows "Disconnected", see Connection Issues.
  3. Are sensor values populating? The energy flow panel should show non-zero values for production and consumption. If values are zero or unavailable, see Connection Issues.
  4. Are devices configured? At least one device must be added in Settings > Devices.
  5. Are priorities configured and enabled? At least one priority entry must exist and be enabled in Settings > Priorities.
  6. Is surplus sufficient? Check the smoothed surplus value on the dashboard. It must exceed the priority entry's min_surplus_w plus the engine's surplus_buffer_w.
  7. Check the Decision Timeline. The dashboard shows the reason for every skip, activation, and shed. This is the fastest diagnostic tool.

Specific Issues

  • Connection Issues

    HA disconnected, entity values showing zero, WebSocket reconnection.

    Connection Issues

  • Load Control Issues

    Load not activating, rapid cycling, stuck states, setpoint not adjusting.

    Load Issues

  • Configuration Issues

    Validation errors, config not persisting after restart.

    Configuration Issues

Getting Help

If the troubleshooting pages do not resolve your issue:

  1. Check the add-on logs: Settings > Add-ons > Hanergy > Log. Look for lines containing level=ERROR.
  2. Review the Decision Timeline on the dashboard for skip reasons.
  3. Verify entities in HA Developer Tools > States to confirm they report expected values.
  4. File an issue on GitLab with the relevant log section and your configuration (remove entity IDs if you prefer privacy).
  5. Email support@hanergy.app for direct assistance.