Repository navigation
Configuration
After installation, you configure the OpenEVSE integration through the Home Assistant UI. No YAML editing is required.
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:
- Go to Settings → Devices & Services.
- Find the OpenEVSE card in the Discovered section.
- Click Configure and follow the prompts.
If auto-discovery does not find your charger:
- Go to Settings → Devices & Services.
- Click + Add Integration (bottom right).
- Search for OpenEVSE and select it.
- 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.
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+).
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 |
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 |
| 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. |
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 |
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 |
To change the host/IP or credentials later, go to:
Settings → Devices & Services → OpenEVSE → ⋮ → Reconfigure
- See Entities & Platforms for a full list of entities exposed by the integration.
- See Services Reference to start automating your charger.