evcc

evcc

Official

Docker app from Nodiaque's Repository

Overview

evcc is an energy management system with a focus on electromobility. The software controls your EV charger or smart plug. It communicates with your vehicle, inverter or home storage to make intelligent charging decisions. The software is open source and community-driven. You need to create a evcc.yaml file for the docker to work. Follow the instruction here: https://docs.evcc.io/en/docs/installation/docker Easy way is to get the zip file on your computer and run evcc configure --lang en Then, copy the file in evcc appdata folder The file must exist before starting the docker or it will start a demo version. Default config put the evcc.yaml at the root of the appdata\evcc folder in Unraid. If you start the docker before creating the file, docker will create a folder named evcc.yaml instead of mapping a file. You will need to delete the folder, create the file and also delete and recreate the mapping else Docker will continue to try to map a folder instead of a file. Unfortunately, the file is mapped in /etc/evcc.yaml so we cannot just map a folder You can freely remove all port forward after OCPP Port if you don't need them.

evcc 🚘☀️

Build Statuspage Translation Docker Pulls OSS hosting by cloudsmith Latest Version
Built with Depot

evcc is an extensible EV Charge Controller and home energy management system.

Screenshot

Our goal is to provide local energy management, without relying on cloud services. Featured in PV Magazine and c’t Magazin.

Features

  • simple and clean user interface
  • support for many EV chargers:
    • ABB, ABL, Alfen, Alphatec, Amperfied, Ampure, Audi, AUTEL, Autoaid, Bender, BMW, cFos, Charge Amps, Compleo, CUBOS, Cupra, Dadapower, DaheimLaden, Delta, E.ON Drive, E3/DC, Easee, Ebee, echarge, EcoHarmony, Edgetech, Elecq, eledio, Elli, EM2GO, EN+, enercab, Ensto, EntraTek, ESL, eSystems, Etrel, EVBox, Free2Move, Free2move eSolutions, Fronius, Garo, go-e, Hardy Barth, Heidelberg, Hesotec, Homecharge, Huawei, Innogy, INRO, Juice, Kathrein, KEBA, Kontron Solar, Kostal, KSE, LadeFoxx, LRT, Mennekes, NRGkick, OBO Bettermann, OpenEVSE, openWB, Optec, Orbis, PC Electric, Peblar, Phoenix Contact, Plugchoice, Porsche, Pracht, Pulsares, Pulsatrix, Qcells, Schneider, Schrack, SENEC, Siemens, Skoda, SMA, Smartfox, SolarEdge, Solax, Sonnen, Spelsberg, Stark in Strom, Sungrow, TechniSat, Tesla, Tigo, TinkerForge, Ubitricity, V2C Trydan, Vestel, Victron, Viridian EV, Volkswagen, Volt Time, Wallbe, wallbox, Walther Werke, Webasto, Weidmüller, Zaptec, ZJ Beny. Read more.
    • EEBus support (Elli, PMCC)
    • OCPP support
    • build-your-own: Phoenix Contact (includes ESL Walli), EVSE DIN
    • smart switches: AVM, FRITZ!, Home Assistant, Homematic IP, HomeWizard, myStrom, Shelly, Tasmota, TP-Link. Read more.
    • heat pumps and electric heaters: alpha innotec, Bosch, Buderus, Bösch, CTA All-In-One, Daikin, Elco, IDM, Junkers, Kermi, Lambda, my-PV, Nibe, Novelan, Roth, Stiebel Eltron, Tecalor, Vaillant, Viessmann, Wolf, Zewotherm. Read more.
  • support for many energy meters:
    • solar inverters and battery systems: A-Tronix, Acrel, Ads-tec, Alpha ESS, Ampere, Anker, APsystems, AVM, Axitec, BGEtech, Bosch, Bosswerk, Carlo Gavazzi, Deye, E3/DC, Eastron, Enphase, FENECON, FRITZ!, FoxESS, Fronius, Ginlong, go-e, GoodWe, Growatt, Homematic IP, HomeWizard, Hoymiles, Huawei, IAMMETER, IGEN Tech, Kostal, LG, Loxone, M-TEC, Marstek, myStrom, OpenEMS, Powerfox, Qcells, RCT, SAJ, SAX, SENEC, Senergy, Shelly, Siemens, Sigenergy, SMA, Smartfox, SofarSolar, Solaranzeige, SolarEdge, SolarMax, Solarwatt, Solax, Solinteng, Sonnen, St-ems, Steca, Sungrow, Sunsynk, Sunway, Tasmota, Tesla, TP-Link, VARTA, Victron, Wattsonic, Youless, ZCS Azzurro, Zendure. Read more.
    • general energy meters: A-Tronix, ABB, Acrel, Alpha ESS, Ampere, AVM, Axitec, Bernecker Engineering, BGEtech, Bosch, Carlo Gavazzi, cFos, Deye, DSMR, DZG, E3/DC, Eastron, Enphase, ESPHome, FENECON, FoxESS, FRITZ!, Fronius, Ginlong, go-e, GoodWe, Growatt, Homematic IP, HomeWizard, Huawei, IAMMETER, inepro, IOmeter, Janitza, KEBA, Kostal, LG, Loxone, M-TEC, mhendriks, my-PV, myStrom, OpenEMS, ORNO, P1Monitor, Powerfox, Qcells, RCT, Saia-Burgess Controls (SBC), SAJ, SAX, Schneider Electric, SENEC, Shelly, Siemens, Sigenergy, SMA, Smartfox, SofarSolar, Solaranzeige, SolarEdge, SolarMax, Solarwatt, Solax, Solinteng, Sonnen, St-ems, Sungrow, Sunsynk, Sunway, Tasmota, Tesla, Tibber, TQ, VARTA, Victron, Volkszähler, Wago, Wattsonic, Weidmüller, Youless, ZCS Azzurro, Zuidwijk. Read more.
    • integrated systems: SMA Sunny Home Manager and Energy Meter, KOSTAL Smart Energy Meter (KSEM, EMxx)
    • sunspec-compatible inverter or home battery devices
    • mbmd-compatible devices, see volkszaehler/mbmd for a complete list
  • vehicle integrations (state of charge, remote charge, battery and preconditioning status):
    • Aiways, Audi, BMW, Citroën, Dacia, DS, Fiat, Ford, Genesis, Hyundai, Jeep, Kia, Mercedes-Benz, MG, Mini, Nissan, NIU, Opel, Peugeot, Polestar, Renault, Seat, Skoda, Smart, Subaru, Tesla, Toyota, Volkswagen, Volvo, Zero Motorcycles. Read more.
    • services: OVMS, Tronity, evNotify, ioBroker.bmw, mg2mqtt, mz2mqtt, TeslaLogger, TeslaMate, Tessi, volvo2mqtt
  • plugins for integrating with any charger, smartswitch, heatpump, electric heater, meter, solar- / battery-inverter or vehicle:
    • Modbus, HTTP, MQTT, JavaScript, WebSocket, Go and shell scripts
  • status notifications using Telegram, PushOver and many more
  • logging using InfluxDB and Grafana
  • REST and MQTT APIs for integration with home automation systems
  • Add-ons for Home Assistant and openHAB (not maintained by the evcc core team)

Getting Started

You'll find everything you need in our documentation.

Contributing

Technical details on how to contribute, how to add translations and how to build evcc from source can be found here.

Weblate Hosted

Sponsorship

evcc believes in open source software. We're committed to provide best in class EV charging experience. Maintaining evcc consumes time and effort. With the vast amount of different devices to support, we depend on community and vendor support to keep evcc alive.

While evcc is open source, we would also like to encourage vendors to provide open source hardware devices, public documentation and support open source projects like ours that provide additional value to otherwise closed hardware. Where this is not the case, evcc requires "sponsor token" to finance ongoing development and support of evcc.

Learn more about our sponsorship model.

License

This project is licensed under the MIT License. See the LICENSE file for details.

For additional license information regarding fonts, icons, and other assets, please see the LICENSES folder.

Note: All sponsor-required components are excluded from the MIT License. See file license header for details. If you want to use them in your own project, one evcc sponsorship token is required per evcc instance. Custom licensing agreements are available - please contact us to discuss your specific requirements.

Install Evcc on Unraid in a few clicks.

Find Evcc in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for Evcc Review the template variables and paths Click Install

Categories

Download Statistics

4,220,591
Total Downloads
428,915
This Month
288,157
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Explore more like this

Explore all

Details

Repository
evcc/evcc:latest
Last Updated2026-06-30
First Seen2025-04-03

Runtime arguments

Web UI
http://[IP]:[PORT:7070]/
Network
bridge
Shell
sh
Privileged
false
Extra Params
--restart=on-failure:5

Template configuration

Web UI PortPorttcp

Web UI Port

Target
7070
Default
7070
Value
7070
OCPP Server PortPorttcp

Port used for OCPP Server

Target
8887
Default
8887
Value
8887
Modbus UDP PortPortudp

Modbus UDP Port

Target
8899
Default
8899
Value
8899
EEBus PortPorttcp

EEBus Port

Target
4712
Default
4712
Value
4712
KEBA Chargers PortPortudp

KEBA Chargers Port

Target
7090
Default
7090
Value
7090
SMA Sunny Home Manager PortPortudp

SMA Sunny Home Manager Port

Target
9522
Default
9522
Value
9522
EVCC Yaml file - Must be created before starting containerPathrw

Configuration file for the EVCC Server. The file must be created before running the container. Check documentation

Target
/etc/evcc.yaml
Default
/mnt/user/appdata/evcc/evcc.yaml
Value
/mnt/user/appdata/evcc/evcc.yaml
EVCC DB FolderPathrw

Directory for internal database

Target
/root/.evcc
Default
/mnt/user/appdata/evcc/db/
Value
/mnt/user/appdata/evcc/db/