Skip to content
smart charging

Tesla Powerwall (pypowerwall-server)

This page shows the nightly version. There is no release version yet.

Uses pypowerwall-server as backend. Reads come from its proxy API, battery control uses its authenticated /control/* routes. For battery control, PW_CONTROL_SECRET must be set on the server; reserve_hold requires pypowerwall-server v0.10.0 or later. Since pypowerwall-server v0.14.0 the server can optionally serve HTTPS on port 8775. Without a TLS reverse proxy or the HTTPS listener it stays plain HTTP; with controlSecret, prefer HTTPS or a trusted network.

Supported features

  • Battery control: External control of home battery charging and discharging via evcc.

Usage areas

  • Grid meter
  • Solar production
  • Battery

Parameters

NameDescriptionValueLevel
hostIP address or hostname
Example: 192.0.2.2
optional
portPort
Default: 8675
optional
capacity [kWh]Battery capacity
Example: 50
optional
minsoc [%]Minimum charge

Lower limit as configured on the battery system. Used by optimizer.

Default: 0
Example: 25
optional
maxsoc [%]Maximum charge

Upper limit as configured on the battery system. Used by optimizer and, on some devices, for grid charging.

Default: 100
Example: 95
optional
schemaSchema

Use https when the server has PW_HTTPS enabled or is behind a TLS reverse proxy. Set the port to the HTTPS port, usually 8775, when using the server's HTTPS listener.

Default: http
advanced
insecureAccept self-signed certificatesadvanced
cacheCache

Time interval for data refresh

Default: 1s
Example: 5m
advanced
controlSecretControl secret

Value of PW_CONTROL_SECRET. Required for battery control, omit for read-only use.

advanced
maxchargepower [W]Maximum charge power

Highest power the battery system can charge with. The optimizer plans with charging up to this power. Some devices also use it as grid charging power.

advanced
maxdischargepower [W]Maximum discharge power

Highest power the battery system can discharge with. The optimizer plans with discharging up to this power. Smart mode assumes the battery supplies at most this power to vehicle charging.

advanced
Configuration example for evcc.yaml

If you don't want to configure via the UI, you can alternatively use this YAML block.

meters:
- name: my_grid
type: template
template: tesla-powerwall-pypowerwall-server
usage: grid
host: 192.0.2.2 # IP address or hostname
port: 8675 # Port, optional
schema: http # Schema, Use https when the server has PW_HTTPS enabled or is behind a TLS reverse proxy. Set the port to the HTTPS port, usually 8775, when using the server's HTTPS listener. [https, http] (optional)
insecure: # Accept self-signed certificates, optional
cache: 1s # Cache, Time interval for data refresh (optional)
meters:
- name: my_pv
type: template
template: tesla-powerwall-pypowerwall-server
usage: pv
host: 192.0.2.2 # IP address or hostname
port: 8675 # Port, optional
schema: http # Schema, Use https when the server has PW_HTTPS enabled or is behind a TLS reverse proxy. Set the port to the HTTPS port, usually 8775, when using the server's HTTPS listener. [https, http] (optional)
insecure: # Accept self-signed certificates, optional
cache: 1s # Cache, Time interval for data refresh (optional)
meters:
- name: my_battery
type: template
template: tesla-powerwall-pypowerwall-server
usage: battery
host: 192.0.2.2 # IP address or hostname
port: 8675 # Port, optional
capacity: 50 # Battery capacity (kWh), optional
minsoc: 0 # Minimum charge (%), Lower limit as configured on the battery system. Used by optimizer. (optional)
maxsoc: 100 # Maximum charge (%), Upper limit as configured on the battery system. Used by optimizer and, on some devices, for grid charging. (optional)
schema: http # Schema, Use https when the server has PW_HTTPS enabled or is behind a TLS reverse proxy. Set the port to the HTTPS port, usually 8775, when using the server's HTTPS listener. [https, http] (optional)
insecure: # Accept self-signed certificates, optional
cache: 1s # Cache, Time interval for data refresh (optional)
controlSecret: # Control secret, Value of PW_CONTROL_SECRET. Required for battery control, omit for read-only use. (optional)
maxchargepower: # Maximum charge power (W), Highest power the battery system can charge with. The optimizer plans with charging up to this power. Some devices also use it as grid charging power. (optional)
maxdischargepower: # Maximum discharge power (W), Highest power the battery system can discharge with. The optimizer plans with discharging up to this power. Smart mode assumes the battery supplies at most this power to vehicle charging. (optional)