Skip to main content

Linux / Raspberry Pi

This guide is aimed at apt-based Linux distributions like Debian, Ubuntu, and Raspberry Pi OS.

note

For other Linux distributions, see the Docker guide or Manual Installation section.

Installation​

  • Open a terminal

  • Install required dependencies:

    sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl

  • Add the evcc APT repository:

Current stable release

curl -1sLf 'https://dl.evcc.io/public/evcc/stable/setup.deb.sh' | sudo -E bash
note

Hosted By: Cloudsmith

We would like to thank Cloudsmith for hosting the repository! Cloudsmith provides services to support the development of free software and platforms.

  • Update the package list:

    sudo apt update

  • Install evcc:

    sudo apt install -y evcc

  • Start the evcc server:

    sudo systemctl start evcc

  • Now check the installation by opening a browser to http://localhost:7070. You should see the evcc web interface in demo mode.

  • Stop the server:

    sudo systemctl stop evcc
note

During installation, a user evcc is created, so ensure the logged-in user does not have the name evcc.

Configuration​

A working evcc configuration is required. The configuration contains general settings and definitions for individual components (meters, wallboxes, vehicles, ...).

Create​

We recommend using the configuration wizard:

  • Start the configuration wizard and answer the questions:
sudo evcc configure
  • Move the created configuration file to /etc/evcc.yaml:
sudo mv evcc.yaml /etc
  • Restart the evcc server:
sudo systemctl restart evcc

Modify​

If your configuration needs adjustments, you can either rerun the configuration wizard (see above) or manually edit the configuration file.

  • Edit the configuration file:
sudo nano /etc/evcc.yaml
  • Restart the evcc server:
sudo systemctl restart evcc

For more information and examples on configuring evcc, see Configuration.

Upgrades​

To update to the latest version of evcc, follow this guide:

  • Check the releases for breaking changes (BC) for your installation

  • Open a terminal

  • Update the package list:

    sudo apt update

  • Upgrade evcc:

    sudo apt --only-upgrade install -y evcc
info

If the unstable repository (nightly versions) has been added, the update will always be updated to the latest available nightly version. If this is no longer desired, the unstable repository can be removed using sudo rm /etc/apt/sources.list.d/evcc-unstable.list.

Downgrade​

If you need to go backwards for any reason, you can do so with this command:

  sudo apt install evcc=x.xxx.x # Version Number

System Service​

evcc runs as a background system service. Here's some useful commands to control it:

sudo systemctl status evcc # shows status
sudo systemctl start evcc # start the service, if it isn't already running
sudo systemctl stop evcc # stops the service
sudo systemctl restart evcc # restart the service
sudo systemctl enable evcc # sets the service to run at boot
sudo systemctl disable evcc # stops the service running at boot

Testing​

Check the installation

  • Show the running evcc service:

    sudo systemctl status evcc

  • Check the latest log entries of the evcc service:

    sudo journalctl -u evcc --since "yesterday"

  • Validate the meter configuration:

    sudo evcc -l debug meter

  • Validate the charger configuration:

    sudo evcc -l debug charger

  • Validate the vehicle configuration:

    sudo evcc -l debug vehicle

Open a browser and enter the following URL: http://127.0.0.1:7070.

note

Replace 127.0.0.1 with the IP address or hostname of the computer if the browser is not opened on the same computer.

Backup and Restore​

To restore the "original state" after a reinstallation, it is sufficient to back up the configuration file evcc.yaml and the database file evcc.db. The storage location is specified in the log file at program start. Typically, the configuration is located under /etc/evcc.yaml and the database under /var/lib/evcc/evcc.db.

Both files can be copied using the Linux command cp.

Example (copying from the usual storage location to the home directory):

Copy yaml: sudo cp /etc/evcc.yaml /home/pi/evcc.yaml.bak

Copy db: sudo cp /var/lib/evcc/evcc.db /home/pi/evcc.db.bak

Manual Installation​

In addition to the Debian/Ubuntu APT package, we also provide other binaries for Linux.

Installation​

  • Download the appropriate file for your system:

  • Extract the downloaded file (e.g., by double-clicking).

  • The extracted folder contains an evcc program.

  • Open a terminal and navigate to the new folder.

  • Check if evcc works with this command:

    ./evcc -v

  • You should see the current version of evcc (e.g., evcc version 0.xxx.y).

Configuration​

Create a working evcc.yaml configuration file following the Configuration guide. You can start it with this command:

./evcc -c evcc.yaml

Upgrade/Downgrade​

Follow the steps above and replace the evcc program file with the new or previous version. The configuration does not need to be redone.

Setting up the Service​

For production use, you'll want to set up evcc as a system service. This ensures evcc starts when the computer boots and automatically restarts in case of errors.

note

This documentation assumes Linux supports systemd.