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.

Important

On 16.02.2025 with evcc version 0.200.1 we followed the Home Assistant approach on how to store user configuration data hold by addons. We are handling this for you, so you should not face any issues. If you need help, ask here.

What exactly has changed?

• Your configuration file i.e. evcc.yaml which was previously saved within /homeassistant/is now transfered to /addon_configs/<slug>_evcc/.
• Your database file i.e. evcc.db is only transfered to /addon_configs/<slug>_evcc/ if you manually moved it to /homeassistant/ before, otherwise it will stay untouched in /data/.
• If you used subfolders, we are keeping them. If you used custom naming of your configuration or database file, we are also keeping them.
• Your old file /homeassistant/evcc.yaml will be renamed to /homeassistant/evcc.yaml.migrated and can be manually deleted. The same applies to the evcc.db if you had it under /homeassistant.

Can I stay with my files in /homeassistant/?

• Basically you can but we do not suggest that! Why? Cause backups of evcc are then not containing your configuration and/or db.
• If you want to ignore that and do it, you need to manually move your files from /addon_configs/<slug>_evcc/ to /homeassistant/ and change the paths in your evcc addon configuration to the new path, i.e. /homeassistant/evcc.yamland restart the evcc addon.

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):

- config_file: /config/evcc.yaml
- sqlite_file: /data/evcc.db

Leave the Network section unchanged.

Create an evcc configuration file evcc.yaml in your Home Assistant root folder (/addon_configs/<slug>_evcc). To access and edit the configuration file, you have plenty options:

• Visual Studio Code, within Visual Studio Code just click the hamburger menu in the upper left and select "File", "Open Folder...", select /addon_configs/<slug>_evcc
• File Editor, ensure that you disabled the option "Enforce Basepath" under File editor addon configuration and restart the File editor addon afterwards, then navigate to /addon_configs/<slug>_evcc
• SSH, navigate to /addon_configs/<slug>_evcc and use nano to edit the file

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/

Configuration of evcc

• https://docs.evcc.io/docs/guides/setup