From 89bca2044cf457c5820f859a507eed01bdfca4b2 Mon Sep 17 00:00:00 2001
From: Michael Geers <michael@geers.tv>
Date: Tue, 7 Apr 2026 10:06:42 +0200
Subject: [PATCH] Clarify linux override

---
 docs/installation/linux.mdx                              | 9 +++++++++
 .../current/installation/linux.mdx                       | 9 +++++++++
 2 files changed, 18 insertions(+)

diff --git a/docs/installation/linux.mdx b/docs/installation/linux.mdx
index 1dcb24ff5..167e2bf9b 100644
--- a/docs/installation/linux.mdx
+++ b/docs/installation/linux.mdx
@@ -231,11 +231,20 @@ Du kannst das Verhalten über eine Override-Datei anpassen:
 sudo systemctl edit evcc
 ```
 
+:::warning
+Bearbeite nicht direkt `/lib/systemd/system/evcc.service`.
+Diese Datei wird bei jedem Paket-Update durch `apt` überschrieben und deine Änderungen gehen verloren.
+Verwende stattdessen immer einen systemd Drop-in über `systemctl edit evcc`.
+:::
+
 ### Beispiel
 
 ```ini title="/etc/systemd/system/evcc.service.d/override.conf"
 [Service]
 Environment="EVCC_LOG=debug,tariff:trace"
+Environment="EVCC_DATABASE_DSN=/usb/evcc/evcc.db"
+Environment="EVCC_NETWORK_HOST=my-evcc.local"
+Environment="EVCC_NETWORK_PORT=80"
 ExecStart=
 ExecStart=/usr/bin/evcc --custom-css /path/to/my.css
 ```
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/installation/linux.mdx b/i18n/en/docusaurus-plugin-content-docs/current/installation/linux.mdx
index 7592e8508..01c55bbd8 100644
--- a/i18n/en/docusaurus-plugin-content-docs/current/installation/linux.mdx
+++ b/i18n/en/docusaurus-plugin-content-docs/current/installation/linux.mdx
@@ -232,11 +232,20 @@ You can customize the behavior using an override file:
 sudo systemctl edit evcc
 ```
 
+:::warning
+Don't edit `/lib/systemd/system/evcc.service` directly.
+That file is overwritten by `apt` on every package update and your changes will be lost.
+Always use a systemd drop-in via `systemctl edit evcc` instead.
+:::
+
 ### Example
 
 ```ini title="/etc/systemd/system/evcc.service.d/override.conf"
 [Service]
 Environment="EVCC_LOG=debug,tariff:trace"
+Environment="EVCC_DATABASE_DSN=/usb/evcc/evcc.db"
+Environment="EVCC_NETWORK_HOST=my-evcc.local"
+Environment="EVCC_NETWORK_PORT=80"
 ExecStart=
 ExecStart=/usr/bin/evcc --custom-css /path/to/my.css
 ```