Skip to content

Configuration

firstof9@gmail.com edited this page Oct 2, 2026 · 2 revisions

Configuration

After installation, you configure the OpenEVSE integration through the Home Assistant UI. No YAML editing is required.


Initial Setup

Auto-Discovery (Zeroconf)

If your charger is on the same network as Home Assistant, it will be discovered automatically via Zeroconf/mDNS. You will see a notification in the Home Assistant dashboard:

  1. Go to Settings → Devices & Services.
  2. Find the OpenEVSE card in the Discovered section.
  3. Click Configure and follow the prompts.

Manual Setup

If auto-discovery does not find your charger:

  1. Go to Settings → Devices & Services.
  2. Click + Add Integration (bottom right).
  3. Search for OpenEVSE and select it.
  4. Fill in the connection details:
Field Description Default
Host / IP Address Hostname or IP of your charger openevse.local
Username HTTP auth username (if enabled on charger) (optional)
Password HTTP auth password (if enabled on charger) (optional)

Note

If you are using HTTPS / SSL, you must first upload your certificate files to the OpenEVSE device via its own web interface before enabling SSL here.


Advanced Options (Integration Options)

After the integration is set up, you can configure advanced features by clicking Configure on the OpenEVSE integration card:

Settings → Devices & Services → OpenEVSE → Configure

When configuring options, you can choose from the following menu:

  • Configure sensor entities: Configure external power and vehicle sensors.
  • Install TLS/SSL certificate: Upload and install a TLS/SSL certificate and private key (requires firmware 4.0.0+).
  • Install root CA certificate: Upload and install a trusted Root CA certificate (requires firmware 4.0.0+).

External Sensor Inputs

These sensors feed data into the charger for smart features like Solar PV Divert and Current Shaper.

Option Unit Purpose
Grid Sensor Watts (W) Net grid power (positive = import, negative = export — unless Invert Grid is on)
Solar Sensor Watts (W) Solar generation power
Voltage Sensor Volts (V) Grid voltage for accurate power calculations
Shaper Sensor Watts (W) Live household power consumption for overload protection
Invert Grid — Toggle if your grid sensor reports export as negative

Vehicle & Battery Sensors

These push vehicle and home battery state data to the charger to enable SoC/range/ETA-based charging limits.

Option Unit Purpose
Vehicle State of Charge % Vehicle battery percentage
Vehicle Range km/mi Remaining vehicle range
Vehicle Time-to-Full-Charge — Estimated completion time (ISO-8601 timestamp)
Home Battery SoC % Home storage battery percentage
Home Battery Power Watts (W) Home storage battery power

Other Options

Option Purpose
GitHub Personal Access Token Increases GitHub API rate limit from 60 to 5,000 req/hr for firmware update checks. Generate one at GitHub → Settings → Developer settings → Personal access tokens. No scopes required.

Install TLS/SSL Certificate (firmware 4.0.0+)

Allows uploading and installing a TLS/SSL server certificate onto the OpenEVSE gateway directly from Home Assistant.

Field Description Required
Certificate Name Identifier/name for the certificate (e.g. web_server) Yes
Certificate PEM-formatted certificate file content (including -----BEGIN CERTIFICATE----- and -----END CERTIFICATE-----) Yes
Private Key PEM-formatted private key content (including -----BEGIN PRIVATE KEY----- or -----BEGIN RSA PRIVATE KEY-----) No

Install Root CA Certificate (firmware 4.0.0+)

Allows installing a trusted Root CA certificate onto the OpenEVSE gateway directly from Home Assistant (e.g. for self-signed or local PKI certificates).

Field Description Required
Certificate Name Identifier/name for the Root CA certificate (e.g. root_ca) Yes
Certificate PEM-formatted Root CA certificate content (including -----BEGIN CERTIFICATE----- and -----END CERTIFICATE-----) Yes

Reconfiguration

To change the host/IP or credentials later, go to:

Settings → Devices & Services → OpenEVSE → ⋮ → Reconfigure


Next Steps

Clone this wiki locally