Skip to main content

macOS

This guide describes the installation for macOS (10.12 and higher) using the Homebrew package manager.

note

If you want to install evcc without a package manager or test a nightly version, check out the Manual Installation section.

Installation​

  • Open a terminal window

  • Install Homebrew, if it's not already installed

  • Add the evcc tap:

    brew tap evcc-io/tap

  • Update package lists:

    brew update

  • Install evcc:

    brew install evcc

  • Start the evcc server:

    brew services start evcc

  • Check the installation by opening a browser and entering the following URL: http://localhost:7070. You should see the evcc interface in demo mode.

  • Stop the evcc server:

    brew services stop evcc

Configuration​

Now you need a working evcc.yaml configuration file. In addition to general settings, the configuration includes the definition of individual components (meter, wallbox, vehicle, ...).

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

  • Start the evcc server:

    brew services start evcc

  • Access the evcc interface at http://localhost:7070

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:

    brew services restart evcc

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

Upgrades​

To upgrade to a new version of evcc, perform the following steps:

  • Open a terminal window

  • Update package lists:

    brew update

  • Upgrade evcc:

    brew install evcc

Additional Commands​

  • Check the status of the evcc server:

    brew services info evcc

  • View logs:

    tail -f /opt/homebrew/var/log/evcc.log

Manual Installation​

Here you'll find instructions for manually installing evcc on macOS.

Installation​

  • Download the appropriate file to your system:
  • Extract the downloaded file (e.g., by double-clicking the file)
  • There will now be a new folder with the evcc program
  • Open a terminal and navigate to the folder containing the evcc program
  • Start evcc with the following 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 instructions under Configuration. You can start it with the following command:

./evcc -c evcc.yaml

Updates/Downgrades​

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