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
- Click -> Add-on Store under Settings - Addons.
- Click -> three dots -> Repositories.
- Copy https://github.com/evcc-io/hassio-addon Click -> Add
- Reload the WebSite (CTRL+R or CTRL+F5 or CTRL+Fn+F5)
- Find the "evcc" add-on and click it.
- 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.
- Now you are ready to go and to start the addon.
- Check the installation by opening the WebUI. You should see the evcc web interface in demo mode.
- If this runs well you can start to edit the evcc.yaml file and creating your own setup (only with the static template possible).
[!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:
- Test each new added device to make sure your new configuration works.
- Once all devices are configured, you can continue on to the setup via the UI.
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).
- Install "Advanced SSH & Web Terminal"
- switch off "secure mode"
- restart addon
- start UI
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/