Skip to content

Sungrow History Relink

bolagnaise edited this page Oct 15, 2026 · 1 revision

Sungrow history relink

Shown only for Sungrow under Configure > Advanced settings > Sungrow history relink. It can relink PowerSync Sungrow energy entities to matching existing mkaiser Sungrow entity IDs so the Energy Dashboard can continue using the existing long-term statistics.

Create a Home Assistant backup before applying. Open the form and read its preview/summary: only ready matches can be applied. Leave Apply ready relinks unconfirmed to inspect without applying. Confirm only after checking the proposed source/destination identities and that the existing statistics belong to the same physical site and measurement.

This is a history/entity migration, not normal telemetry discovery or a fix for incorrect historical readings. A preview with no ready matches does not authorize guessing IDs. After applying, verify the entity IDs, units/statistics continuity and Energy Dashboard before removing old integration entities.

The preview/apply HA services are documented in Services Reference. They are separate actions with the same backup/identity requirements. Do not repeatedly apply a migration merely because the dashboard has not yet refreshed.

Field reference

The tables use the current form labels and help text. They list the conditional field union: a field can be hidden for a different battery, provider, route or available integration. The instructions above explain those conditions. Existing saved/discovered values take precedence over fresh fallbacks. Rate units follow the provider; check the displayed currency/energy unit.

Sungrow history relink — existing installation

Field Meaning / input Fallback / limits
Apply ready relinks Only mappings marked ready will be applied. Ambiguous, missing, and blocked mappings are skipped. Fallback Off

Clone this wiki locally