Skip to content

Document macOS Application Firewall blocking OCPP after brew upgrade #1147

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
naltatis merged 1 commit into from
Aug 7, 2026
Merged

Document macOS Application Firewall blocking OCPP after brew upgrade #1147

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions src/content/docs/de/installation/macos.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -69,6 +69,20 @@ Um auf eine neue Version von evcc zu aktualisieren, führe folgende Schritte dur
brew upgrade evcc
```

:::caution[OCPP und die Firewall]
Bei jedem Upgrade wird eine neue Programmdatei installiert, die die macOS-Firewall als neue Anwendung behandelt.
Ist die Firewall aktiv, werden eingehende Verbindungen blockiert, bis die neue Version freigegeben wurde.
OCPP-Wallboxen können sich dann nicht mehr verbinden, während alles andere weiter funktioniert.
Auf einem Mac ohne Bildschirm bleibt der Freigabedialog unsichtbar.
Gib die Programmdatei deshalb nach jedem Upgrade über das Terminal frei:

```sh
sudo /usr/libexec/ApplicationFirewall/socketfilterfw --add "$(brew --prefix)/opt/evcc/bin/evcc"
brew services restart evcc
```

:::

## Weitere Befehle

- Prüfe den Status des evcc-Servers:
Expand Down
14 changes: 14 additions & 0 deletions src/content/docs/en/installation/macos.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -69,6 +69,20 @@ To upgrade to a new version of evcc, perform the following steps:
brew upgrade evcc
```

:::caution[OCPP and the Application Firewall]
Each upgrade installs a new binary, which the macOS Application Firewall treats as a new application.
If the firewall is enabled, incoming connections are blocked until the new version is approved.
OCPP chargers can no longer connect, while everything else keeps working.
On a headless Mac the approval dialog is never seen.
Approve the binary from the command line after each upgrade:

```sh
sudo /usr/libexec/ApplicationFirewall/socketfilterfw --add "$(brew --prefix)/opt/evcc/bin/evcc"
brew services restart evcc
```

:::

## Additional Commands

- Check the status of the evcc server:
Expand Down