Skip to content

Commit 312e323

Browse files
authored
Remote Access: now experimental (#1079)
1 parent 77a7020 commit 312e323

2 files changed

Lines changed: 16 additions & 32 deletions

File tree

src/content/docs/de/features/remote-access.mdx

Lines changed: 8 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ import clientsImg from "@assets/features/remote-access/clients.png";
1010
import clientCreatedImg from "@assets/features/remote-access/client-created.png";
1111

1212
:::caution[Experimentell]
13-
Remote Access befindet sich in einer frühen Entwicklungsphase und ist aktuell nur per Umgebungsvariable freischaltbar.
13+
Remote Access befindet sich in Entwicklung.
1414
Funktionsweise und Konfiguration können sich noch ändern.
1515
:::
1616

@@ -42,18 +42,7 @@ Remote Access setzt ein aktives [Sponsoring](/de/sponsorship) voraus.
4242

4343
<Steps>
4444

45-
1. Setze auf dem Host, auf dem evcc läuft, die Umgebungsvariable:
46-
47-
```
48-
EVCC_REMOTE_ACCESS=api.evcc.cloud
49-
```
50-
51-
Wie du Umgebungsvariablen dauerhaft setzt, hängt von deiner Installation ab.
52-
Unter Linux geschieht das über ein systemd-Drop-in mit `systemctl edit evcc`, siehe [Umgebungsvariablen & CLI-Optionen](/de/installation/linux#environment).
53-
54-
Starte evcc anschließend neu.
55-
56-
2. Aktiviere die Funktion in der Oberfläche:
45+
1. Aktiviere die Funktion in der Oberfläche:
5746
- **Konfiguration → Experimentell** → aktivieren
5847
- **Konfiguration → Remote Access 🧪** → aktivieren
5948

@@ -63,15 +52,15 @@ Remote Access setzt ein aktives [Sponsoring](/de/sponsorship) voraus.
6352
style={{ maxWidth: "500px" }}
6453
/>
6554

66-
3. Deine evcc-Instanz registriert sich beim Remote-Proxy und erhält eine eigene Domain, z. B. `swift-dark-crow.evcc.cloud`.
55+
2. Deine evcc-Instanz registriert sich beim Remote-Proxy und erhält eine eigene Domain, z. B. `swift-dark-crow.evcc.cloud`.
6756

6857
<img
6958
src={clientsImg.src}
7059
alt="Remote-Access-Verwaltung mit Domain und Client-Liste"
7160
style={{ maxWidth: "500px" }}
7261
/>
7362

74-
4. Lege für jedes Gerät, das Zugriff bekommen soll, einen eigenen Client an.
63+
3. Lege für jedes Gerät, das Zugriff bekommen soll, einen eigenen Client an.
7564
Du bekommst Benutzername, Passwort und einen QR-Code mit beiden Daten.
7665
- **App:** Scanne den QR-Code mit der Kamera deines Smartphones.
7766
Die [evcc-App](/de/features/app) öffnet sich und ist sofort verbunden.
@@ -88,7 +77,7 @@ Remote Access setzt ein aktives [Sponsoring](/de/sponsorship) voraus.
8877
style={{ maxWidth: "500px" }}
8978
/>
9079

91-
5. In derselben Ansicht siehst du, welche Clients zuletzt aktiv waren, und kannst einzelne Geräte jederzeit wieder entfernen.
80+
4. In derselben Ansicht siehst du, welche Clients zuletzt aktiv waren, und kannst einzelne Geräte jederzeit wieder entfernen.
9281
Optional kannst du den Zugriff auch zeitlich befristen.
9382

9483
</Steps>
@@ -141,5 +130,8 @@ Das ist wichtig, weil die evcc-Oberfläche Echtzeitdaten selbst über WebSocket
141130
Bricht der Tunnel ab, verbindet sich die lokale Instanz automatisch neu.
142131
Solange die Verbindung steht, ist die Domain erreichbar, sonst antwortet der Remote-Proxy mit einem Fehler.
143132

133+
Der Host des Remote-Proxys ist standardmäßig `api.evcc.cloud`.
134+
Für Entwicklung oder einen selbst gehosteten Proxy lässt er sich über die Umgebungsvariable `EVCC_REMOTE_ACCESS` ändern.
135+
144136
Der Quellcode des Remote-Proxys wird zu einem späteren Zeitpunkt veröffentlicht.
145137
Details zum Datenschutz findest du in unserer [Datenschutzerklärung](https://evcc.io/datenschutz/).

src/content/docs/en/features/remote-access.mdx

Lines changed: 8 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ import clientsImg from "@assets/features/remote-access/clients.png";
1010
import clientCreatedImg from "@assets/features/remote-access/client-created.png";
1111

1212
:::caution[Experimental]
13-
Remote Access is in an early stage of development and currently only available behind an environment variable.
13+
Remote Access is in development.
1414
Both behaviour and configuration may still change.
1515
:::
1616

@@ -42,18 +42,7 @@ Remote Access requires an active [sponsorship](/en/sponsorship).
4242

4343
<Steps>
4444

45-
1. On the host that runs evcc, set the environment variable:
46-
47-
```
48-
EVCC_REMOTE_ACCESS=api.evcc.cloud
49-
```
50-
51-
How you set environment variables persistently depends on your installation.
52-
On Linux, this is done via a systemd drop-in with `systemctl edit evcc`, see [Environment Variables & CLI Options](/en/installation/linux#environment).
53-
54-
Then restart evcc.
55-
56-
2. Enable the feature in the user interface:
45+
1. Enable the feature in the user interface:
5746
- **Configuration → Experimental** → enable
5847
- **Configuration → Remote Access 🧪** → enable
5948

@@ -63,15 +52,15 @@ Remote Access requires an active [sponsorship](/en/sponsorship).
6352
style={{ maxWidth: "500px" }}
6453
/>
6554

66-
3. Your evcc instance registers with the Remote Proxy and receives its own domain, e.g. `swift-dark-crow.evcc.cloud`.
55+
2. Your evcc instance registers with the Remote Proxy and receives its own domain, e.g. `swift-dark-crow.evcc.cloud`.
6756

6857
<img
6958
src={clientsImg.src}
7059
alt="Remote Access management with domain and client list"
7160
style={{ maxWidth: "500px" }}
7261
/>
7362

74-
4. Create a separate client for every device that should have access.
63+
3. Create a separate client for every device that should have access.
7564
You receive a username, a password, and a QR code containing both.
7665
- **App:** Scan the QR code with your phone's camera.
7766
The [evcc app](/en/features/app) opens and is connected straight away.
@@ -88,7 +77,7 @@ Remote Access requires an active [sponsorship](/en/sponsorship).
8877
style={{ maxWidth: "500px" }}
8978
/>
9079

91-
5. The same view shows which clients were active most recently and lets you revoke individual devices at any time.
80+
4. The same view shows which clients were active most recently and lets you revoke individual devices at any time.
9281
Access can optionally be limited to a fixed period.
9382

9483
</Steps>
@@ -141,5 +130,8 @@ This matters because the evcc UI itself receives live data over WebSocket.
141130
If the tunnel drops, the local instance reconnects automatically.
142131
While the connection is up, your domain is reachable; otherwise the Remote Proxy returns an error.
143132

133+
The Remote Proxy host defaults to `api.evcc.cloud`.
134+
For development or a self-hosted proxy, it can be overridden with the `EVCC_REMOTE_ACCESS` environment variable.
135+
144136
The source code of the Remote Proxy will be published at a later date.
145137
For privacy details, see our [privacy policy](https://evcc.io/en/datenschutz/).

0 commit comments

Comments
 (0)