Skip to content
EN | DE

FreeBSD

This guide describes the installation on FreeBSD using the official package from the FreeBSD Ports tree.

  1. Open a terminal as root and install evcc:

    Terminal window
    pkg install evcc
  2. Enable the service at boot and start it:

    Terminal window
    sysrc evcc_enable="YES"
    service evcc start
  3. Open the evcc interface in your browser: http://localhost:7070. Set an administrator password and configure your devices directly via the web interface.

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

Alternatively, you can use an evcc.yaml configuration file at /usr/local/etc/evcc.yaml. Details can be found in Configuration.

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

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

  • Open a terminal as root

  • Upgrade evcc:

    Terminal window
    pkg upgrade evcc
  • Restart the service:

    Terminal window
    service evcc restart
  • Check the status of the evcc server:

    Terminal window
    service evcc status
  • View logs:

    Terminal window
    tail -f /var/log/evcc.log

If you already have nginx running, add a new virtualhost with the following configuration:

server {
...
server_name evcc.<your-domain>
...
location / {
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header Host $http_host;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_redirect off;
proxy_read_timeout 240s;
proxy_http_version 1.1;
proxy_pass http://127.0.0.1:7070;
}
}

The evcc interface will then be available at http://evcc.<your-domain>/.