Skip to content

Commit 3969d00

Browse files
authored
Document EEBUS SHIP-ID configuration (#910)
1 parent c800575 commit 3969d00

File tree

2 files changed

+20
-2
lines changed
  • docs/reference/configuration
  • i18n/en/docusaurus-plugin-content-docs/current/reference/configuration

2 files changed

+20
-2
lines changed

docs/reference/configuration/eebus.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -93,7 +93,16 @@ interfaces:
9393

9494
### `shipid`
9595

96-
Hiermit kann die zu verwendende Geräte-ID (SKI) definiert werden.
96+
Hiermit kann die zu verwendende SHIP-ID definiert werden.
97+
Dies sollte nur für Entwicklungszwecke notwendig sein.
98+
99+
Normalerweise generiert evcc die SHIP-ID automatisch aus der `machine-id` (auf realer Hardware) oder einer zufällig generierten Plant-ID (in Container-Umgebungen wie Docker), die in der Datenbank gespeichert wird.
100+
Du kannst eine explizite Plant-ID über `plant` in der `evcc.yaml` oder die `EVCC_PLANT` Umgebungsvariable setzen – empfohlen für bessere Portierbarkeit.
101+
Die SHIP-ID ist fest mit dem Zertifikat verknüpft – ändert sich eines von beiden, muss die Kopplung mit den Geräten neu durchgeführt werden.
102+
103+
:::warning Achtung
104+
Ändere diesen Wert nicht manuell, wenn du nicht genau weißt, was du tust.
105+
:::
97106

98107
**Beispiel**:
99108

i18n/en/docusaurus-plugin-content-docs/current/reference/configuration/eebus.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -93,7 +93,16 @@ interfaces:
9393

9494
### `shipid`
9595

96-
Defines the Device ID (SKI) to be used.
96+
Defines the SHIP-ID to be used.
97+
This should only be necessary for development purposes.
98+
99+
Normally evcc generates the SHIP-ID automatically from the `machine-id` (on real hardware) or a randomly generated plant ID (in container environments like Docker), which is stored in the database.
100+
You can set an explicit plant ID via `plant` in `evcc.yaml` or the `EVCC_PLANT` environment variable – recommended for better portability.
101+
The SHIP-ID is tied to the certificate – if either changes, pairing with devices must be redone.
102+
103+
:::warning Warning
104+
Don't change this value manually unless you know exactly what you're doing.
105+
:::
97106

98107
**For example**:
99108

0 commit comments

Comments
 (0)