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

  • Open the evcc interface in your browser: http://localhost:7070

  • The evcc application will ask you to set an administrator password

  • You can then configure your devices directly via the web interface

Configuration​

Recommended

Configure evcc directly in your browser.

After the first start, you can configure evcc at http://localhost:7070. Settings are automatically saved in the database.

Alternatively, you can use an evcc.yaml configuration file at /etc/evcc.yaml. Details can be found in 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 upgrade 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​

After the first start, open http://localhost:7070 in your browser and configure evcc via the web interface.

Alternatively, you can create an evcc.yaml configuration file (see Configuration) and start evcc with it:

./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.