Home

Awesome

evcc 🚘☀️ Home Assistant Addon

[!NOTE] This guide is aimed for users running Home Assistant. Of course it is possible to run EVCC outside Home Assistant too, but as is has a very low footprint running EVCC as an Addon is the simplest ways.

Installation Guide

  1. Click -> Add-on Store under Settings - Addons.
  2. Click -> three dots -> Repositories.
  3. Copy https://github.com/evcc-io/hassio-addon Click -> Add
  4. Reload the WebSite (CTRL+R or CTRL+F5 or CTRL+Fn+F5)
  5. Find the "evcc" add-on and click it.
  6. Click on the "INSTALL" button.

Configuration

Go to Information menu in the "evcc" Addon and activate "show in side bar" (evcc UI http://your-ha-instance-ip-address:7070)

Go to Configuration menu and select your working directory (example):

<!--- <Screenshot name="screenshots/ha_configuration_ui" caption="Screenshot der Arbeitsverzeichnisse und Dateinamen in der Konfiguration." /> --->
- config_file: /config/evcc.yaml
- sqlite_file: /data/evcc.db
<!--- #### New file location > [!WARNING] > First copy your evcc.db and evcc.yaml to /config ( maps to addon_configs/49686a9f_evcc/ ) -> [How to find my evcc.db](https://github.com/evcc-io/hassio-addon/blob/main/README.md#how-to-find-and-copy-dataevccdb) >```sh >- config_file: /config/evcc.yaml >- sqlite_file: /config/evcc.db >``` #### New alternative file location > [!WARNING] > First copy your evcc.db and evcc.yaml to Home Assistant root configuration folder -> [How to find my evcc.db](https://github.com/evcc-io/hassio-addon/blob/main/README.md#how-to-find-and-copy-dataevccdb) >```sh >- config_file: /homeassistant/evcc.yaml >- sqlite_file: /homeassistant/evcc.db >``` --->

Leave the Network section unchanged.

Create an evcc configuration file evcc.yaml in your Home Assistant root configuration folder (/config or /homeassistant).

Copy the content of this Template to your evcc.yaml file you just created. The template creates a default configuration with static demo entities.

[!NOTE] If you want to see evcc how it is running in dynamic demo instead, copy the content of https://github.com/evcc-io/evcc/blob/master/cmd/demo.yaml into your evcc.yaml file.

[!TIP] If you struggle with the manual configuration you might consider to install a standalone evcc Windows or Linux system and using the Configuration wizard.

The Configuration wizard is not available under the Home Assistant environment!!!

You will find it easier to use evcc configure there, and then copy the generated evcc.yaml to the desired system.

[!IMPORTANT] Advanced users (those with evcc experience & some technical know-how) might want to use the advanced configurator:

Installation of the evcc Integration

Proceed with installation process of the evcc Integration for Home Assistant as described in this section Integrations

Upgrades

The upgrade to the latest version of evcc, is included in the Home Assistant update process.

[!TIP]

How to find and copy /data/evcc.db

Create a folder e.g. /evcc in homeassitant config directory (/homeassistant or /config).

docker -ps a

save the CONTAINER ID of evcc/evcc:0.130.12 -> e.g. 6d0b4119b012 (CONTAINER ID of EVCC)

List the files in /data:

docker exec 6d0b4119b012 ls -la /data

Copy your evcc to /config/evcc:

docker cp 6d0b4119b012:/data/evcc.db /homeassistant/evcc/

Configuration of evcc