Configuration

evcc can be configured in two ways:

1. UI Configuration (recommended)

Configuration is done via the web interface under Configuration. Settings are saved automatically in the database. For more information, see Configuration.

2. File-based Configuration

Configuration via the evcc.yaml file remains supported. This section documents the YAML-based configuration.

File-based Configuration (evcc.yaml)

The configuration file is written in YAML format and is called evcc.yaml by default. It is located either in the same directory as evcc itself, or on POSIX (e.g. Linux) systems in /etc/evcc.yaml.

Non-standard paths can be specified at startup: evcc -c /path/to/evcc.yaml

Structure

The configuration file contains multiple sections. To reference between sections, devices have a name parameter for identification.

An example file with many parameters can be found here: https://github.com/evcc-io/evcc/blob/master/evcc.dist.yaml

Here is an overview of the relationship between the most important parts of the configuration:

graph TD;
    site("site (Zuhause)")
    subgraph loadpoints
      loadpointA("Carport (charger: KEBA)")
      loadpointB("Garage (charger: Wallbe)")
    end
    subgraph meters
      meterGrid("Discovergy")
      meterPV("SMA Tripower")
      meterBattery("LG RESU")
    end
    subgraph vehicles
      vehicleA("VW ID.4")
      vehicleB("Renault Zoe")
      vehicleC("Tesla Model Y")
    end

    loadpointA -- loadpoint.1 --> site
    loadpointB -- loadpoint.2 --> site

    vehicleA --> loadpointA
    vehicleB --> loadpointA
    vehicleB --> loadpointB
    vehicleC --> loadpointB

    meterGrid -- meters.grid --> site
    meterPV -- meters.pvs --> site
    meterBattery -- meters.batterys --> site

How does evcc work? (A look into the innards)

In order for the system to function, an electricity meter is important. This allows us to calculate at any point in time the surplus power. Measuring the generated power is interesting, but has no effect on the function, with this exception

The surplus power is compared with the minimum power required to charge. If this is sufficient, the charging process is started.

The minimum power required to charge is calculated from the values minCurrent and phases, defined per loadpoint (a group of colocated chargers) See loadpoints for more information.

For example: phases: 1 und minCurrent: 8

1 (phases) x 8A (minCurrent) x 230V (mains voltage) = 1840W (minimum power required to charge)

Manipulation Options

Normally, the surplus power corresponds to the available charging power. However, the available charging power can be individually adjusted using several parameters. These are:

Site: residualpower
Site: prioritySoc
Site: bufferSoc
Site: aux
Loadpoint: enable: threshold
Loadpoint: disable: threshold

Please refer to the description of each respective parameter for the available settings.

Site

A Site describes the location with the existing and required devices of the home installation and is responsible for regulating the available power.

Loadpoint

A Loadpoint describes the charging infrastructure and combines existing Chargers, Vehicles, and anything else a charging point needs.

Chargers

Chargers include a list of chargers and their properties, such as how they are addressed.

Meters

Meters are a list of devices that measure various power flows. These include:

Imported, Exported power
PV-generated power
Charging current of EV (if the charger does not support this directly)
Power flow of house battery(ies)

Vehicles

To limit the state of charge (SoC) of EVs to a specific level, you can specify the existing vehicles and online access data here.

HEMS

evcc can forward the charging points and their charging currents to another Home Energy Management System (HEMS) so that it can use this information, for example, to control the house battery.

Messaging

In this section, you can define events for which you want to be informed. A variety of different systems are supported for message delivery.

More information