From 83675fb227f46c353eaca3278ed7509be59fe47d Mon Sep 17 00:00:00 2001 From: Matthias Fechner Date: Wed, 8 Apr 2026 09:34:03 +0200 Subject: [PATCH 1/3] Added installation and upgrade manual for evcc on FreeBSD. The evcc FreeBSD package was added with commit: https://cgit.freebsd.org/ports/commit/?id=d1cd65d39dca2bfa2ab96938df1a5f8b54385a54 --- docs/installation/freebsd.md | 100 +++++++++++++++++ docs/installation/index.md | 5 + .../current/installation/freebsd.md | 101 ++++++++++++++++++ .../current/installation/index.md | 5 + 4 files changed, 211 insertions(+) create mode 100644 docs/installation/freebsd.md create mode 100644 i18n/en/docusaurus-plugin-content-docs/current/installation/freebsd.md diff --git a/docs/installation/freebsd.md b/docs/installation/freebsd.md new file mode 100644 index 000000000..d873c0292 --- /dev/null +++ b/docs/installation/freebsd.md @@ -0,0 +1,100 @@ +--- +sidebar_position: 9 +--- + +# FreeBSD + +Diese Anleitung beschreibt die Installation für FreeBSD. + +## Erstinstallation + +- Öffne ein Terminal/Eingabeaufforderung (als root) + +- Installiere evcc + + ```sh + pkg install evcc + ``` + +- evcc automatisch starten (beim Systemstart) + + ```sh + sysrc evcc_enable="YES" + ``` + +- evcc Server jetzt direkt starten: + + ```sh + service evcc start + ``` + +## Konfiguration + +### nginx als Reverse Proxy + +Wenn bereits ein nginx läuft, kann dieser mit einem neuen Virtualhost Eintrag ergänzt werden + +``` +server { + ... + server_name evcc. + ... + 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; + } +} +``` + +- Öffne die evcc Oberfläche in deinem Browser [http://evcc.**your-domain**/](http://evcc.your-domain/) +- Die evcc Oberfläche fordert dich auf ein Administrator-Passwort zu vergeben +- Anschließend kannst du deine Geräte direkt über die Weboberfläche einrichten + +## Aktualisierung + +Um auf eine neue Version von evcc zu aktualisieren, führe folgende Schritte durch: + +- Prüfe [Releases](https://github.com/evcc-io/evcc/releases) für Breaking changes (BC) die deine Installation betreffen +- Öffne ein Terminal/Eingabeaufforderung (als root) +- Aktualisiere evcc: + + ```sh + pkg upgrade evcc + ``` + +- evcc neu starten: + + ```sh + service evcc restart + ``` + +## Weitere Befehle + +- Prüfe den Status des evcc-Servers: + + ```sh + service evcc status + ``` + +- Logs anzeigen: + + ```sh + tail -f /var/log/evcc.log + ``` + +## Backup und Restore {#backup} + +### Über die Weboberfläche (empfohlen) + +Die einfachste Methode ist das Backup über die Weboberfläche. Details findest du unter [Einrichtung → Sichern & Wiederherstellen](./configuration#backup). diff --git a/docs/installation/index.md b/docs/installation/index.md index d1f618cd1..542e6cc0e 100644 --- a/docs/installation/index.md +++ b/docs/installation/index.md @@ -47,6 +47,11 @@ Falls du mehr über die Funktionsweise von Wallboxen und E-Auto-Laden erfahren m title="macOS" description="Via Homebrew." /> + + ... + 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; + } +} +``` + +- Use your browser and open the URI you configured in nginx [http://evcc.**your-domain**/](http://evcc.your-domain/) +- The evcc interface will prompt you to set an administrator password +- You can then configure your devices directly via the web interface + +## Upgrades + +To update to the latest version of evcc, follow this guide: + +- Check the [releases](https://github.com/evcc-io/evcc/releases) for breaking changes (BC) for your installation +- Open a terminal (as root) +- Upgrade evcc: + + ```sh + pkg upgrade evcc + ``` + +- Restart evcc: + + ```sh + service evcc restart + ``` + +## Additional Commands + +- Check the status of the evcc server: + + ```sh + service evcc status + ``` + +- View logs: + + ```sh + tail -f /var/log/evcc.log + ``` + +## Backup and Restore {#backup} + +### Via Web Interface (recommended) + +The easiest method is to backup via the web interface. +See [Configuration → Backup & Restore](./configuration#backup) for details. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/installation/index.md b/i18n/en/docusaurus-plugin-content-docs/current/installation/index.md index 2c9667676..9e52ea364 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/installation/index.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/installation/index.md @@ -47,6 +47,11 @@ If you want to learn more about how wallboxes and EV charging work, first check title="macOS" description="Via Homebrew." /> + Date: Wed, 8 Apr 2026 11:21:49 +0200 Subject: [PATCH 2/3] Removed backup instruction as they are common and not related to installation method --- docs/installation/freebsd.md | 6 ------ .../current/installation/freebsd.md | 7 ------- 2 files changed, 13 deletions(-) diff --git a/docs/installation/freebsd.md b/docs/installation/freebsd.md index d873c0292..a14e9ea8c 100644 --- a/docs/installation/freebsd.md +++ b/docs/installation/freebsd.md @@ -92,9 +92,3 @@ Um auf eine neue Version von evcc zu aktualisieren, führe folgende Schritte dur ```sh tail -f /var/log/evcc.log ``` - -## Backup und Restore {#backup} - -### Über die Weboberfläche (empfohlen) - -Die einfachste Methode ist das Backup über die Weboberfläche. Details findest du unter [Einrichtung → Sichern & Wiederherstellen](./configuration#backup). diff --git a/i18n/en/docusaurus-plugin-content-docs/current/installation/freebsd.md b/i18n/en/docusaurus-plugin-content-docs/current/installation/freebsd.md index 2abc95cd0..bc5b12974 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/installation/freebsd.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/installation/freebsd.md @@ -92,10 +92,3 @@ To update to the latest version of evcc, follow this guide: ```sh tail -f /var/log/evcc.log ``` - -## Backup and Restore {#backup} - -### Via Web Interface (recommended) - -The easiest method is to backup via the web interface. -See [Configuration → Backup & Restore](./configuration#backup) for details. From a16e370477460bfe75234c2570224e6ee8f3f2b6 Mon Sep 17 00:00:00 2001 From: Michael Geers Date: Wed, 13 May 2026 14:57:44 +0200 Subject: [PATCH 3/3] align content order --- docs/installation/freebsd.md | 66 +++++++++---------- .../current/installation/freebsd.md | 64 +++++++++--------- 2 files changed, 65 insertions(+), 65 deletions(-) diff --git a/docs/installation/freebsd.md b/docs/installation/freebsd.md index a14e9ea8c..66b6c1394 100644 --- a/docs/installation/freebsd.md +++ b/docs/installation/freebsd.md @@ -10,54 +10,25 @@ Diese Anleitung beschreibt die Installation für FreeBSD. - Öffne ein Terminal/Eingabeaufforderung (als root) -- Installiere evcc +- Installiere evcc: ```sh pkg install evcc ``` -- evcc automatisch starten (beim Systemstart) +- evcc automatisch starten (beim Systemstart): ```sh sysrc evcc_enable="YES" ``` -- evcc Server jetzt direkt starten: +- Starte den evcc-Server: ```sh service evcc start ``` -## Konfiguration - -### nginx als Reverse Proxy - -Wenn bereits ein nginx läuft, kann dieser mit einem neuen Virtualhost Eintrag ergänzt werden - -``` -server { - ... - server_name evcc. - ... - 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; - } -} -``` - -- Öffne die evcc Oberfläche in deinem Browser [http://evcc.**your-domain**/](http://evcc.your-domain/) +- Öffne die evcc Oberfläche in deinem Browser: [http://localhost:7070](http://localhost:7070) - Die evcc Oberfläche fordert dich auf ein Administrator-Passwort zu vergeben - Anschließend kannst du deine Geräte direkt über die Weboberfläche einrichten @@ -92,3 +63,32 @@ Um auf eine neue Version von evcc zu aktualisieren, führe folgende Schritte dur ```sh tail -f /var/log/evcc.log ``` + +## nginx als Reverse Proxy + +Wenn bereits ein nginx läuft, kann dieser mit einem neuen Virtualhost-Eintrag ergänzt werden: + +``` +server { + ... + server_name evcc. + ... + 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; + } +} +``` + +Anschließend ist die evcc Oberfläche unter [http://evcc.**your-domain**/](http://evcc.your-domain/) erreichbar. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/installation/freebsd.md b/i18n/en/docusaurus-plugin-content-docs/current/installation/freebsd.md index bc5b12974..aad248697 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/installation/freebsd.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/installation/freebsd.md @@ -10,13 +10,13 @@ This guide describes the installation for FreeBSD. - Open a terminal (as root) -- Install evcc +- Install evcc: ```sh pkg install evcc ``` -- Enable evcc daemon +- Enable evcc to start at boot: ```sh sysrc evcc_enable="YES" @@ -28,36 +28,7 @@ This guide describes the installation for FreeBSD. service evcc start ``` -## Configuration - -### nginx As Reverse Proxy - -If you have a nginx running, just add a new virtualhost with following configuration - -``` -server { - ... - server_name evcc. - ... - 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; - } -} -``` - -- Use your browser and open the URI you configured in nginx [http://evcc.**your-domain**/](http://evcc.your-domain/) +- Open the evcc interface in your browser: [http://localhost:7070](http://localhost:7070) - The evcc interface will prompt you to set an administrator password - You can then configure your devices directly via the web interface @@ -92,3 +63,32 @@ To update to the latest version of evcc, follow this guide: ```sh tail -f /var/log/evcc.log ``` + +## nginx as Reverse Proxy + +If you already have nginx running, add a new virtualhost with the following configuration: + +``` +server { + ... + server_name evcc. + ... + 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**/](http://evcc.your-domain/).