FATAL: cannot create meter 'xxx': cannot create meter type 'template:solaredge-hybrid': missing required `maxacpower`

[Stony111]

Describe the bug

Nach dem Update auf die aktuelle Version 0.313.0 startet evcc nicht mehr korrekt. Es kommt diese Fehlermeldung:

[main ] FATAL 2026/07/31 08:01:14 meter [se_inverter_pv_gartenhaus_pv] cannot create meter 'se_inverter_pv_gartenhaus_pv': cannot create meter type 'template:solaredge-hybrid': missing required 'maxacpower'

Lt. Dokumentation sollte aber der Parameter "maxacpower" bei einem SolarEdge-Wechselrichter keine erforderliche Option sein:

In der Version 0.312.1 lief alles noch problemlos. In meiner evcc.yaml ist beim Wechselrichter der Parameter "maxacpower" auch nicht angegeben!

evcc läuft bei mir als Home Assistant App!

Würde jetzt einfach in meiner evcc.yaml den Parameter mit dem Wert 0 angeben, aber bin mir nicht sicher, ob die neue Prüfung auf "Muss-Option" bei einem Solaredge-Wechselrichter nicht doch ein kleiner Bug ist!

Steps to reproduce

1. Neue Version 0.313.0 installieren und starten
2. bei einem Solaredge-Wechselrichter kommt sofort der Fehler im Log und UI

Configuration details

Hier ein Auszug aus meiner evcc.yaml:

# meter definitions
# name can be freely chosen and is used as reference when assigning meters to site and loadpoints
# for documentation see https://docs.evcc.io/docs/devices/meters
meters:
  - name: se_inverter_pv_gartenhaus_grid
    type: template
    template: solaredge-hybrid
    usage: grid
    modbus: tcpip
    id: 1
    host: 192.168.120.45 # Hostname
    port: 2502 # Port

  - name: se_inverter_pv_gartenhaus_pv
    type: template
    template: solaredge-hybrid
    usage: pv
    modbus: tcpip
    id: 1
    host: 192.168.120.45 # Hostname
    port: 2502 # Port

  - name: se_inverter_pv_haus_pv
    type: template
    template: solaredge-hybrid
    usage: pv
    modbus: tcpip
    id: 5
    host: 192.168.120.45 # Hostname
    port: 2502 # Port

...

Log details

Config: configured (/config/evcc.yaml), exists
Database: configured (/data/evcc.db), exists
[main  ] INFO 2026/07/31 08:01:10 evcc 0.313.0
[main  ] INFO 2026/07/31 08:01:10 using config file: /config/evcc.yaml
[main  ] FATAL 2026/07/31 08:01:14 meter [se_inverter_pv_gartenhaus_pv] cannot create meter 'se_inverter_pv_gartenhaus_pv': cannot create meter type 'template:solaredge-hybrid': missing required `maxacpower`
[main  ] FATAL 2026/07/31 08:01:14 will attempt restart in: 15m0s
Config: configured (/config/evcc.yaml), exists
Database: configured (/data/evcc.db), exists
[main  ] INFO 2026/07/31 08:16:14 evcc 0.313.0
[main  ] INFO 2026/07/31 08:16:14 using config file: /config/evcc.yaml
[main  ] FATAL 2026/07/31 08:16:20 meter [se_inverter_pv_gartenhaus_pv] cannot create meter 'se_inverter_pv_gartenhaus_pv': cannot create meter type 'template:solaredge-hybrid': missing required `maxacpower`
[main  ] FATAL 2026/07/31 08:16:20 will attempt restart in: 15m0s
Config: configured (/config/evcc.yaml), exists
Database: configured (/data/evcc.db), exists
[main  ] INFO 2026/07/31 08:28:34 evcc 0.312.1
[main  ] INFO 2026/07/31 08:28:34 using config file: /config/evcc.yaml
Config: configured (/config/evcc.yaml), exists
Database: configured (/data/evcc.db), exists
[main  ] INFO 2026/07/31 08:42:05 evcc 0.312.1
[main  ] INFO 2026/07/31 08:42:05 using config file: /config/evcc.yaml


Hinweis: Hab ja wieder auf die Version 0.312.1 downgegraded und dann ging der Start wieder fehlerfrei durch!

What type of operating system or environment does evcc run on?

HomeAssistant Add-on

External automation

• I have made sure that no external automation like HomeAssistant or Node-RED is active or accessing any of the mentioned devices when this issue occurs.

Nightly build

• I have verified that the issue is reproducible with the latest nightly build

Version

No response

[github-actions]

Root cause

templates/definition/meter/solaredge-hybrid.yaml marks the maxacpower param as required: true without scoping it to a specific usage. maxacpower is only actually used in the pv branch of the template's render (for the curtailment percent/power conversion), but the requirement check applies to every usage. So meters with usage: grid or usage: battery — like se_inverter_pv_gartenhaus_grid in the reported config — now fail with missing required 'maxacpower', even though it was never needed for those usages.

This was introduced by the curtailment feature added in #31982, which added maxacpower as unconditionally required.

Other templates handle this correctly by scoping the param to usages: ["pv"] (see templates/definition/meter/sungrow-ihm.yaml and sma-hybrid.yaml's watchdog param), which is the fix applied here.

Fix

Opened #32327, adding usages: ["pv"] to the maxacpower param in templates/definition/meter/solaredge-hybrid.yaml so it's only required for usage: pv meters, restoring the previous (documented) behavior for grid/battery usages.

🤖 Generated with Claude Code

[andig]

The error message is clear. Please see release notes- the information needs be added since it's required for curtailment now.