Skip to content

Commit c536a87

Browse files
naltatisnaltatis
committed
homeassistant
1 parent df77cae commit c536a87

3 files changed

Lines changed: 78 additions & 37 deletions

File tree

‎UI_CONFIG_RELEASE_TODO.md‎

Lines changed: 16 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -60,22 +60,25 @@ Started: 2025-12-16
6060

6161
### 5. Platform-Specific Installation Guides
6262

63-
- [ ] Update `/docs/installation/docker.mdx`
64-
- [ ] Remove requirement for evcc.yaml in prerequisites
65-
- [ ] Add note about UI configuration option
66-
- [ ] Update volumes section to clarify evcc.yaml is optional
67-
- [ ] Update `/docs/installation/linux.mdx`
68-
- [ ] Update first-start instructions to mention UI setup
69-
- [ ] De-emphasize evcc.yaml creation
70-
- [ ] Update `/docs/installation/macos.md`
71-
- [ ] Update first-start instructions
63+
- [x] Update `/docs/installation/docker.mdx`
64+
- [x] Remove requirement for evcc.yaml in prerequisites
65+
- [x] Add note about UI configuration option
66+
- [x] Update volumes section to clarify evcc.yaml is optional
67+
- [x] Update `/docs/installation/linux.mdx`
68+
- [x] Update first-start instructions to mention UI setup
69+
- [x] De-emphasize evcc.yaml creation
70+
- [x] Update `/docs/installation/macos.md`
71+
- [x] Update first-start instructions
7272
- [x] Update `/docs/installation/windows.mdx`
7373
- [x] Update first-start instructions
7474
- [x] Add UI configuration as primary method
7575
- [x] De-emphasize evcc.yaml creation
76-
- [ ] Update `/docs/installation/home-assistant.mdx`
77-
- [ ] Mention UI configuration as primary method
78-
- [x] Update English translation of windows.mdx
76+
- [x] Update `/docs/installation/home-assistant.mdx`
77+
- [x] Mention UI configuration as primary method
78+
- [x] Restructure to show UI method first
79+
- [x] Make evcc.yaml optional
80+
- [x] Update English translations of windows.mdx and home-assistant.mdx
81+
- [x] Update English translations of docker.mdx, linux.mdx and macos.md
7982

8083
### 6. FAQ Updates
8184

@@ -168,4 +171,4 @@ Started: 2025-12-16
168171
- In Progress: 0
169172
- Remaining: 50
170173

171-
Last Updated: 2025-12-16
174+
Last Updated: 2025-12-17

‎docs/installation/home-assistant.mdx‎

Lines changed: 30 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -75,7 +75,11 @@ Siehe [Home Assistant Dokumentation](https://www.home-assistant.io/installation/
7575
</TabItem>
7676
</Tabs>
7777

78-
## Konfigurationsdatei
78+
## Konfiguration
79+
80+
evcc kann auf zwei Arten konfiguriert werden:
81+
82+
### Weboberfläche (empfohlen)
7983

8084
Gehe im **evcc** Add-on in den Tab **Information** und aktiviere **In Seitenleiste anzeigen** (evcc UI http://your-ha-instance-ip-address:7070)
8185

@@ -84,28 +88,43 @@ Gehe zum Tab **Konfiguration** und wähle dein Arbeitsverzeichnis aus (Beispiel)
8488
![Image](screenshots/ha_configuration_ui.webp)
8589

8690
```sh
87-
- config_file: /config/evcc.yaml
8891
- sqlite_file: /data/evcc.db
8992
```
9093

9194
Lasse den Abschnitt Netzwerk unverändert.
9295

93-
Lege eine leere Konfigurationsdatei `evcc.yaml` in deinem Add-on-Stammkonfigurationsordner (`/addon_configs/49686a9f_evcc`) an.
94-
Falls dieser Ordner noch nicht exisiert, erstelle ihn manuell.
96+
Starte das Add-on.
97+
Öffne dann die evcc Oberfläche über die Seitenleiste:
98+
99+
- Du wirst aufgefordert ein Administrator-Passwort zu vergeben
100+
- Anschließend kannst du deine Geräte direkt über die Weboberfläche einrichten
101+
- Die Einstellungen werden automatisch in der Datenbank gespeichert
102+
103+
### Konfigurationsdatei (traditionell)
104+
105+
Alternativ kannst du eine `evcc.yaml` Konfigurationsdatei verwenden.
106+
107+
Gehe zum Tab **Konfiguration** und füge die Konfigurationsdatei zu deinem Arbeitsverzeichnis hinzu:
95108

96-
Um die Konfigurationsdatei anzulegen bzw. zu editieren, hast du verschiedene Möglichkeiten, hier ein paar zur Auswahl:
109+
```sh
110+
- config_file: /config/evcc.yaml
111+
- sqlite_file: /data/evcc.db
112+
```
97113

98-
- [Visual Studio Code](https://github.com/hassio-addons/addon-vscode), in Visual Studio Code wähle das Hamburger-Menü oben links aus und wähle "File", "Open Folder...", select `/addon_configs/49686a9f_evcc`
99-
- [File Editor](https://github.com/home-assistant/addons/tree/master/configurator), stelle sicher, dass Du die Option "Enforce Basepath" in der Add-on Konfiguration deaktiviert hast, starte das Add-on neu und navigiere nach `/addon_configs/49686a9f_evcc`
100-
- [Advanced SSH & Web Terminal](https://github.com/hassio-addons/addon-ssh), navigiere nach `/addon_configs/49686a9f_evcc` und verwende z. B. nano
114+
Lege eine Konfigurationsdatei `evcc.yaml` in deinem Add-on-Stammkonfigurationsordner (`/addon_configs/49686a9f_evcc`) an.
115+
Falls dieser Ordner noch nicht existiert, erstelle ihn manuell.
101116

102-
Unter [evcc.yaml erstellen](./configuration) findest du eine Anleitung, wie du den Inhalt für die `evcc.yaml` erstellen kannst.
117+
Um die Konfigurationsdatei anzulegen bzw. zu editieren, hast du verschiedene Möglichkeiten:
118+
119+
- [Visual Studio Code](https://github.com/hassio-addons/addon-vscode): Wähle das Hamburger-Menü oben links aus und wähle "File", "Open Folder...", select `/addon_configs/49686a9f_evcc`
120+
- [File Editor](https://github.com/home-assistant/addons/tree/master/configurator): Stelle sicher, dass du die Option "Enforce Basepath" in der Add-on Konfiguration deaktiviert hast, starte das Add-on neu und navigiere nach `/addon_configs/49686a9f_evcc`
121+
- [Advanced SSH & Web Terminal](https://github.com/hassio-addons/addon-ssh): Navigiere nach `/addon_configs/49686a9f_evcc` und verwende z. B. nano
122+
123+
Details zur Erstellung der Konfigurationsdatei findest du unter [Einrichtung](./configuration).
103124

104125
Wenn du erstmal mit einer Demo starten möchtest, starte evcc mit dem Parameter `--demo`.
105126
Weitere Informationen findest du unter [CLI Referenz](/docs/reference/cli/evcc).
106127

107-
Jetzt bist du bereit und kannst das Add-on starten.
108-
109128
## Aktualisierungen
110129

111130
Die Aktualisierung auf die neueste Version von evcc ist in den Home Assistant Update-Prozess integriert.

‎i18n/en/docusaurus-plugin-content-docs/current/installation/home-assistant.mdx‎

Lines changed: 32 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -75,36 +75,55 @@ See [Home Assistant Documentation](https://www.home-assistant.io/installation/#a
7575
</TabItem>
7676
</Tabs>
7777

78-
## Configuration File
78+
## Configuration
7979

80-
Go to Information menu in the "evcc" Addon and activate "show in sidebar" (evcc UI http://your-ha-instance-ip-address:7070)
80+
evcc can be configured in two ways:
8181

82-
Go to Configuration menu and select your working directory (example):
82+
### Web Interface (recommended)
83+
84+
Go to the **Information** tab in the **evcc** addon and activate **Show in sidebar** (evcc UI http://your-ha-instance-ip-address:7070)
85+
86+
Go to the **Configuration** tab and select your working directory (example):
8387

8488
![Image](screenshots/ha_configuration_ui.webp)
8589

8690
```sh
87-
- config_file: /config/evcc.yaml
8891
- sqlite_file: /data/evcc.db
8992
```
9093

9194
Leave the Network section unchanged.
9295

93-
Create an empty evcc configuration file `evcc.yaml` in your Addon root configuration folder (`/addon_configs/49686a9f_evcc`).
96+
Start the addon.
97+
Then open the evcc interface via the sidebar:
98+
99+
- You'll be prompted to set an administrator password
100+
- You can then configure your devices directly via the web interface
101+
- Settings are automatically saved in the database
102+
103+
### Configuration File (traditional)
104+
105+
Alternatively, you can use an `evcc.yaml` configuration file.
106+
107+
Go to the **Configuration** tab and add the configuration file to your working directory:
108+
109+
```sh
110+
- config_file: /config/evcc.yaml
111+
- sqlite_file: /data/evcc.db
112+
```
113+
114+
Create an evcc configuration file `evcc.yaml` in your addon root configuration folder (`/addon_configs/49686a9f_evcc`).
94115
If this folder does not exist, create it manually.
95116

96-
To create or edit the configuration file, you have many options, here are a few:
117+
To create or edit the configuration file, you have several options:
97118

98-
- [Visual Studio Code](https://github.com/hassio-addons/addon-vscode), in Visual Studio Code select the hamburger menu in the top left and choose "File", "Open Folder...", select `/addon_configs/49686a9f_evcc`
99-
- [File Editor](https://github.com/home-assistant/addons/tree/master/configurator), make sure you have disabled the "Enforce Basepath" option in the Addon configuration, restart the Addon and navigate to `/addon_configs/49686a9f_evcc`
100-
- [Advanced SSH & Web Terminal](https://github.com/hassio-addons/addon-ssh), navigate to `/addon_configs/49686a9f_evcc` and use e.g. nano
119+
- [Visual Studio Code](https://github.com/hassio-addons/addon-vscode): Select the hamburger menu in the top left and choose "File", "Open Folder...", select `/addon_configs/49686a9f_evcc`
120+
- [File Editor](https://github.com/home-assistant/addons/tree/master/configurator): Make sure you have disabled the "Enforce Basepath" option in the addon configuration, restart the addon and navigate to `/addon_configs/49686a9f_evcc`
121+
- [Advanced SSH & Web Terminal](https://github.com/hassio-addons/addon-ssh): Navigate to `/addon_configs/49686a9f_evcc` and use e.g. nano
101122

102-
Under [Configuration](./configuration) you'll find instructions on how to create the content for the `evcc.yaml`.
123+
See [Configuration](./configuration) for details on creating the configuration file.
103124

104125
If you want to see the system running in demo mode, just start evcc with the parameter `--demo`.
105-
See [CLI Referenz](/docs/reference/cli/evcc) for more information.
106-
107-
Now you are ready and can start the addon.
126+
See [CLI Reference](/docs/reference/cli/evcc) for more information.
108127

109128
## Updates
110129

0 commit comments

Comments
 (0)