Phaeton-Handbuch
Phaeton auf Ihrem GX installieren
Herunterladen, auf einen USB-Stick kopieren, den GX neu starten und im Browser abschließen.
Empfohlen: Installation per USB
Sie können ohne Terminalbefehle und ohne SSH-Zugang installieren. Ein Einrichtungscode ist nicht nötig. Ihr GX kann während der Installation offline bleiben.
Halten Sie einen leeren USB-Stick und einen Computer mit Internet bereit. Sie müssen den Stick selbst einstecken und den GX neu starten können. Danach öffnen Sie Phaeton über VRM oder im lokalen Netzwerk des GX.
Schon installiert?
Starten Sie mit dem USB-Installer neu, um die Version vom Stick zu installieren, auch als Neuinstallation oder Downgrade. Phaeton sichert die Installation auf dem GX, behält Konfiguration, Identität und Lizenzen und prüft dann den neuen Prozess. Startet er nicht, wird die vorherige Installation wiederhergestellt. Hinweise zur Konfiguration finden Sie unter Settings; im Wiederherstellungsmodus bleibt das Laden gesperrt, bis gültige Einstellungen gespeichert sind und Phaeton neu startet. Getrennte benannte Instanzen behalten ihre eigene Software. Online- und Offline-Updates sind auch über „Software Updates“ in Phaeton möglich. Um ohne SSH eine zweite Wallbox hinzuzufügen, öffnen Sie im Control Panel der per USB installierten Wallbox System → Chargers on this GX.
1. USB-Installer herunterladen
GX-USB-Installer herunterladen (0.66.107)
Lassen Sie die heruntergeladene .tgz-Datei ungeöffnet. Entpacken Sie sie nicht und benennen Sie sie nicht um.
Welche GX-Geräte können diesen Installer nutzen?
Dieser Installer ist für GX-Geräte mit 32-Bit-Venus-OS, etwa den Cerbo GX, Cerbo-S GX, Ekrano GX, Venus GX, Octo GX, MultiPlus-II GX und EasySolar-II GX, sowie Venus OS auf einem Raspberry Pi 2, 3 oder 4. Neuere Cerbo GX und der Raspberry Pi 5 laufen mit 64-Bit-Venus-OS: Dort bricht der Installer mit einer Meldung ab; nutzen Sie dann die SSH-Installation unten.
Die Datei heißt venus-data-phaeton-VERSION-armv7.tgz. Für andere Linux-Geräte nutzen Sie die erweiterten Downloads unten. Eine .phaeton-update-Datei dient zum Aktualisieren von Phaeton über seine Weboberfläche.
2. Auf den USB-Stick kopieren
Nehmen Sie einen leeren, beschreibbaren FAT32-USB-Stick mit mindestens 256 MB freiem Speicher. Brauchen Sie Hilfe beim Formatieren, lesen Sie die Hinweise unten.
Kopieren Sie die ungeöffnete .tgz-Datei direkt auf den USB-Stick, nicht in einen Ordner. Werfen Sie den Stick am Computer aus, wenn das Kopieren fertig ist.
USB-Stick vorbereiten
Der Stick braucht eine MBR-Partitionstabelle. Formatieren löscht den Inhalt; sichern Sie vorher Dateien, die Sie behalten möchten. Sind Sie beim Format unsicher, bitten Sie Ihren Installateur um Hilfe. Nehmen Sie keinen Stick, auf dem der GX Protokolle speichert.
Kopieren unter Windows, macOS oder Linux
Windows: Kopieren Sie das Archiv im Explorer aus Downloads direkt auf das USB-Laufwerk und wählen Sie dann Auswerfen.
macOS: Kopieren Sie das Archiv im Finder aus Downloads direkt auf das USB-Laufwerk und klicken Sie dann auf das Auswerfen-Symbol. Schalten Sie in Safari vorher „Sichere Dateien nach dem Laden öffnen“ aus; wurde die Datei schon entpackt, laden Sie sie erneut herunter.
Linux: Kopieren Sie das Archiv mit Ihrem Dateimanager aus Downloads direkt auf das USB-Laufwerk und werfen Sie das Laufwerk dann sicher aus.
3. Stick einstecken und GX neu starten
Prüfen Sie am GX-Display oder in der Remote Console Settings → General → Modification checks → Modifications enabled. Die Menünamen entsprechen der englischen Oberfläche von Venus OS und hängen von der Firmware ab. Lassen Sie die Option eingeschaltet, damit Phaeton nach einem Neustart startet.
Trennen Sie andere Wechseldatenträger. Stecken Sie den Stick in einen USB-Datenanschluss; der reine Stromanschluss für das GX Touch kann ihn nicht lesen. Starten Sie neu, wenn ein Neustart kein Laden und keine andere wichtige Arbeit unterbricht.
Planen Sie fünf Minuten für den Start ein und warten Sie, bis der USB-Stick nicht mehr arbeitet. Ziehen Sie keinen aktiven Stick ab und unterbrechen Sie nicht die Stromversorgung des GX. Sind Sie unsicher, ob Sie den Stick abziehen können, lassen Sie ihn stecken und kontaktieren Sie den Support. Die Einrichtung können Sie im Browser abschließen.
4. Phaeton öffnen und Einrichtung abschließen
Nach einer neuen Installation melden Sie sich bei VRM an, öffnen Ihre Installation und wählen Device list → Phaeton EV Charging Station → Control Panel. Während der Einrichtung heißt das Gerät Phaeton. Geben Sie der Geräteliste nach dem Start Zeit zum Aktualisieren.
Ihr GX muss online sein, Settings → VRM → VRM Portal muss auf „Full“ stehen, und Ihr VRM-Konto muss Einstellungen ändern dürfen. Ihr Browser kann in einem anderen Netzwerk sein. Remote Console öffnet die Oberfläche des GX; Phaeton öffnen Sie mit dem Control Panel.
VRM öffnen · VRM-Einstellungen und Hilfe zur Verbindung
Phaeton im lokalen Netzwerk öffnen
Die IP-Adresse des GX finden Sie unter Settings → Ethernet oder Settings → Wi-Fi → Ihr verbundenes Netzwerk. Öffnen Sie im selben vertrauenswürdigen lokalen Netzwerk https://GX-IP:8088/ im Browser und ersetzen Sie GX-IP durch diese Adresse.
Zertifikatswarnung im Browser
Lokales HTTPS nutzt ein eigenes Zertifikat von Phaeton, daher zeigt Ihr Browser eventuell eine Datenschutzwarnung. Öffnen Sie nach dem sicheren Entfernen des Sticks PHAETON-RESULT.html auf Ihrem Computer und vergleichen Sie den öffentlichen SHA-256-Fingerabdruck des Zertifikats mit den Zertifikatsdetails im Browser, bevor Sie Zugangsdaten eingeben. Stimmen die Fingerabdrücke nicht überein, brechen Sie ab. Dieser Offline-Bericht enthält keine Zugangsdaten für die Einrichtung. VRM nutzt ein eigenes HTTPS-Zertifikat; der Abgleich mit dem USB-Fingerabdruck gilt nur für den lokalen Zugriff.
Wählen Sie Benutzernamen und Passwort für den Phaeton-Administrator. Verbinden Sie Wallbox und GX mit Hilfe des Assistenten. Aktivieren Sie Phaeton danach mit Ihrem Portalkonto. Ihr VRM-Konto, die Phaeton-Anmeldung und das Konto im Lizenzportal sind getrennt.
Phaeton erst testen, ohne Lizenz
Wählen Sie im Assistenten „Dummy — no license required“ als Wallbox. Alles ist simuliert und es fließt kein Strom, so können Sie Ladeseite, Zeitplan und Einstellungen kostenlos ausprobieren. Wechseln Sie später unter Settings zu Ihrer echten Wallbox; erst dann wird die Lizenz geprüft.
Anleitung zur Vorbereitung der Wallbox
Ein GX ohne Internet lässt sich aktivieren, indem Sie Anfrage- und Lizenzdatei über einen Computer mit Internet austauschen. Prüfen Sie Dashboard und Verbindung zur Wallbox, bevor Sie einen Ladetest starten.
Installation nicht abgeschlossen oder Ergebnisdatei fehlt
Öffnen Sie nach dem sicheren Entfernen PHAETON-RESULT.html und PHAETON-<GX-Identität>.log auf Ihrem Computer. Das Protokoll listet die Schritte und Ergebnisse des Installers für diesen GX auf, ohne Konfiguration und ohne Zugangsdaten. Fehlt eine der Dateien oder meldet eine davon eine noch laufende Installation oder einen Fehler, folgen Sie der Anleitung zur USB-Wiederherstellung. Schreibgeschützte Datenträger können kein Ergebnis aufnehmen. Ein wiederverwendeter Stick kann noch das Ergebnis eines früheren GX enthalten, wenn der Installer nie gestartet ist; prüfen Sie die Einrichtung am aktuellen GX.
Venus legt eventuell auch die Datei vrmlogger-backlog.sqlite3 für seine eigenen VRM-Protokolle an. Sie wird für die Einrichtung nicht gebraucht; bewahren Sie VRM-Daten auf, die noch nicht hochgeladen wurden.
Phaeton über das VRM Control Panel öffnen
Auf dem GX richtet Phaeton seinen VRM-Control-Panel-Zugang selbst ein und repariert ihn bei Bedarf. Eine neue Installation per USB oder SSH können Sie schon vor der Einrichtung über das Control Panel öffnen; eine bestehende Modbus-Installation erhält den Zugang, sobald Einrichtung und Aktivierung abgeschlossen sind. Bei einem Update bleiben Backend, Identität und Steuerungseinstellungen erhalten.
GX einrichten
- Nutzen Sie das GX-Display oder die Remote Console. Verbinden Sie den GX unter Settings → Connectivity → Ethernet / Wi-Fi mit dem Internet; in älteren Menüs steht Ethernet / Wi-Fi direkt unter Settings.
- Öffnen Sie Settings → VRM → VRM Portal, bei älterer Firmware Settings → VRM online portal → VRM Portal. Wählen Sie „Full“, wenn der Eigentümer die Konfiguration aus der Ferne erlauben möchte.
- Prüfen Sie im selben VRM-Menü, ob „Last contact“ aktuell ist und kein Verbindungsfehler angezeigt wird. Registrieren Sie den GX bei Bedarf in Ihrer VRM-Installation. Ihr VRM-Konto muss Einstellungen ändern dürfen.
- Lassen Sie Settings → General → Modification checks → Modifications enabled eingeschaltet, damit Phaeton normal startet. Bei unterstützten Installationen richtet Phaeton seinen Control-Panel-Zugang nach dem Start selbst ein.
Phaeton öffnen
- Installieren Sie Phaeton mit dem USB- oder SSH-Installer auf dem GX oder halten Sie eine bestehende Installation aktuell. Bei Modbus müssen Einrichtung und Aktivierung zuerst lokal abgeschlossen sein. Geben Sie der Geräteliste nach dem Start Zeit zum Aktualisieren.
- Melden Sie sich bei VRM an, öffnen Sie Ihre Installation und wählen Sie „Device list“. Klappen Sie die gewünschte Phaeton EV Charging Station auf und wählen Sie „Control Panel“. Während der Einrichtung heißt der Eintrag Phaeton. Remote Console öffnet die Oberfläche des GX.
- Legen Sie bei der ersten Einrichtung Ihr Phaeton-Administratorkonto an oder melden Sie sich mit Ihren bestehenden Phaeton-Zugangsdaten an. VRM meldet Sie nicht bei Phaeton an. Ihr VRM-Konto, Ihr lokales Phaeton-Konto und Ihr Konto im Lizenzportal sind getrennt.
Behalten Sie das bestehende Sicherheitsprofil des lokalen Netzwerks bei. MQTT-Installationen nutzen intern den lokalen Broker; Modbus-Installationen brauchen für diesen Zugang kein MQTT. Das Einschalten von LAN-MQTT oder der Kopplung von Netzwerkgeräten richtet den Webzugang nicht ein. Das Control Panel braucht weder SSH im LAN noch Remote Support oder eine Portweiterleitung am Router.
Lokales HTTPS bleibt für die Inbetriebnahme ohne Internet unter https://GX-IP:8088/ verfügbar. Um ohne SSH eine zweite Wallbox hinzuzufügen, öffnen Sie im Control Panel der per USB installierten Wallbox System → Chargers on this GX.
Fehlt das Control Panel oder öffnet es die Oberfläche des GX, prüfen Sie Installationsart, Internetverbindung des GX, den VRM-Modus „Full“ und die Berechtigungen. Prüfen Sie Status und Protokolle des Control Panels in Phaeton (den Status auf der Standardinstallation unter System → Chargers on this GX); unterstützte Installationen reparieren ihren Zugang alle 30 Sekunden. Prüfen Sie außerdem, ob Phaeton aktuell ist, die lokalen Verbindungseinstellungen unterstützt werden und das Control Panel aktiviert ist. Lokal geht es unter https://GX-IP:8088/ weiter. Der USB-Fingerabdruck gehört zu diesem lokalen Zertifikat; VRM nutzt ein eigenes HTTPS-Zertifikat.
Die Firmwareversion in VRM ist eine Kompatibilitätsangabe für die EVCS, nicht die installierte Phaeton-Version. Verwaltete Control-Panel-Installationen melden v1.29. Ein deaktivierter oder nicht verfügbarer Modbus-Zugang kann v1.22 behalten, ebenso eine ältere oder deaktivierte MQTT-Registrierung. Wenn Sie nur diese Nummer ändern, wird der nötige Webzugang nicht eingerichtet; prüfen Sie zuerst Status und Protokolle des Control Panels.
Erweiterte Installation per SSH
1. Voraussetzungen prüfen
Nutzen Sie diesen Weg, wenn Sie keinen USB-Stick verwenden können oder lieber mit einem Terminal arbeiten. Folgen Sie den sechs Schritten an einem Computer im selben lokalen Netzwerk wie Ihr GX. Der SSH-Installer lädt die Software selbst herunter; ein weiteres Konto ist nicht nötig.
- Ein GX-Gerät mit Venus OS, etwa ein Cerbo GX oder Ekrano GX, und die Berechtigung, seine Einstellungen zu ändern. Der SSH-Installer wählt selbst das Paket für 32-Bit- oder 64-Bit-Venus-OS.
- Internetzugang am GX und ein Windows-, macOS- oder Linux-Computer im selben lokalen Netzwerk. Eine VRM-Verbindung allein verbindet Ihren Computer nicht per SSH mit dem GX.
- Eine unterstützte Wallbox und Zugang zu ihren Verbindungseinstellungen. Lesen Sie die Anleitung zur Vorbereitung der Wallbox, bevor Sie sich auf die Ladesteuerung verlassen.
2. GX vorbereiten
Nutzen Sie das GX-Display, oder melden Sie sich bei Victron VRM an, öffnen Sie Ihre Installation und wählen Sie „Remote Console“. Kennen Sie die IP-Adresse des GX schon, öffnen Sie sie im lokalen Netzwerk im Browser. Lassen Sie den Einstellungsbildschirm des GX geöffnet.
Die IP-Adresse finden Sie unter Settings → Ethernet oder Settings → Wi-Fi → Ihr verbundenes Netzwerk. Nehmen Sie die Adresse des Netzwerks, in dem Ihr Computer ist.
Zum Beispiel 192.168.1.50. Geben Sie nur die Adresse ein, ohne http:// und ohne Port. Sie bleibt in diesem Browser und wird nicht an die Phaeton-Website gesendet.
- Legen Sie unter General / Access & Security ein vorübergehendes Root-Passwort fest. Wählen Sie ein eigenes Passwort und merken Sie es sich für den nächsten Schritt; ZZZ ist nicht Ihr SSH-Passwort.
- Schalten Sie „SSH on LAN“ ein. „Remote Support“ müssen Sie bei aktuellem Venus OS nicht einschalten.
- Öffnen Sie General → Modification checks und stellen Sie sicher, dass „Modifications enabled“ eingeschaltet ist, damit Phaeton nach einem Neustart startet.
Die Menünamen entsprechen der englischen Oberfläche von Venus OS und können je nach Version abweichen. Wurde das Passwort ZZZ für die Zugriffsebene geändert, fragen Sie Ihren Installateur. Sieht Ihr Bildschirm anders aus, nutzen Sie die bebilderte Anleitung von Victron zum Root-Zugang.
3. Vom Computer aus verbinden
Windows: Öffnen Sie das Startmenü, geben Sie PowerShell ein und öffnen Sie Windows PowerShell oder Terminal. Fügen Sie den Befehl unten ein und drücken Sie die Eingabetaste.
macOS: Öffnen Sie Spotlight mit Befehlstaste + Leertaste, geben Sie Terminal ein und öffnen Sie es. Fügen Sie den Befehl unten ein und drücken Sie die Return-Taste.
Linux: Öffnen Sie Ihr Terminal. Fügen Sie den Befehl unten ein und drücken Sie die Eingabetaste.
Auf Ihrem Computer ausführen
ssh root@<gx-ip>- Bei der ersten Verbindung zeigt SSH einen Fingerabdruck des Host-Schlüssels. Prüfen Sie, ob die Adresse zu Ihrem GX gehört, und bestätigen Sie den Schlüssel bei Bedarf über ein vertrauenswürdiges Gerät oder einen Administrator; akzeptieren Sie nur ein Gerät, das Sie kennen. Eine unerwartete Warnung über einen geänderten Schlüssel muss geklärt werden.
- Geben Sie das vorübergehende Root-Passwort ein, das Sie gerade am GX festgelegt haben. Beim Tippen erscheint nichts, auch keine Punkte; das ist normal. Drücken Sie die Eingabetaste.
- Eine Eingabeaufforderung, die mit root@ beginnt, zeigt, dass Sie mit dem GX verbunden sind. Lassen Sie dieses Terminal geöffnet, bis die Installation fertig ist.
Hilfe zur Verbindung
- Connection refused: Prüfen Sie, ob „SSH on LAN“ eingeschaltet ist.
- Connection timed out: Prüfen Sie die Adresse des GX und ob beide Geräte im selben lokalen Netzwerk sind; ein Gast-WLAN oder VPN kann sie trennen.
- Permission denied: Nutzen Sie root als Benutzernamen und Ihr vorübergehendes Root-Passwort des GX. Ein Firmware-Update von Venus setzt dieses Passwort zurück.
- ssh wird nicht erkannt: Aktivieren Sie in Windows die optionale Funktion OpenSSH-Client und öffnen Sie PowerShell erneut.
4. Phaeton installieren
Sie sind jetzt im Terminal des GX. Kopieren Sie den gesamten Befehl, fügen Sie ihn an der Eingabeaufforderung root@ ein und drücken Sie die Eingabetaste. Lassen Sie das Terminal geöffnet, bis der Installer fertig ist.
Nach dem Verbinden auf dem GX ausführen
(installer=$(mktemp) && trap 'rm -f "$installer"' EXIT && curl -fL --connect-timeout 15 --max-time 120 https://phaeton.virtunet.io/install/gx.sh -o "$installer" && sh "$installer")Der Installer prüft den GX, lädt die stabile Version herunter, prüft ihre Signatur, installiert sie und wartet auf die Weboberfläche. Er richtet den Autostart ein, ohne die Startbefehle anderer Software zu ersetzen.
Hilfe zur Installation
- Download fehlgeschlagen: Prüfen Sie den Internetzugang des GX und führen Sie den Befehl erneut aus.
- Nicht unterstütztes Gerät oder zu wenig Speicher: Folgen Sie der Meldung, bevor Sie es erneut versuchen. Nehmen Sie nicht auf gut Glück eine andere Programmdatei.
- Modifications disabled: Schalten Sie „Modifications enabled“ im Menü des GX ein. Ist eine alte Startdatei deaktiviert, folgen Sie den Hinweisen des Installers zur Wiederherstellung.
- Phaeton läuft bereits: Nutzen Sie in Phaeton „Software Updates“. Ein erneuter Installationsbefehl aktualisiert keine laufende Instanz.
- Weboberfläche nicht bereit: Lassen Sie das Terminal geöffnet und folgen Sie dem Protokoll des Installers und seinen Hinweisen zum erneuten Versuch. Die Installation ist noch nicht abgeschlossen.
5. Phaeton öffnen
Nach einer neuen Installation können Sie Phaeton über VRM → Ihre Installation → Device list → Phaeton EV Charging Station → Control Panel öffnen. Nötig sind Internet am GX, der VRM-Modus „Full“ und die Berechtigung, Einstellungen zu ändern. Bei der ersten Einrichtung suchen Sie nach Phaeton.
Phaeton über das VRM Control Panel öffnen
Der Installer zeigt die Webadresse von Phaeton und den SHA-256-Fingerabdruck des Zertifikats. Öffnen Sie Phaeton und wählen Sie Ihren lokalen Administrator-Benutzernamen und Ihr Passwort. Ein Einrichtungscode ist nicht nötig.
Bei lokalem HTTPS warnt Ihr Browser eventuell, dass die Verbindung nicht privat ist, weil dieser GX ein eigenes Zertifikat nutzt. Öffnen Sie vor dem Fortfahren die Zertifikatsdetails und vergleichen Sie den SHA-256-Fingerabdruck mit der Ausgabe des Installers. Fahren Sie nur fort, wenn beide übereinstimmen. VRM nutzt ein eigenes HTTPS-Zertifikat.
https://<gx-ip>:8088/
Nutzen Sie die HTTPS-Adresse, die der Installer anzeigt, falls sie abweicht. Diese Schaltfläche öffnet die eingegebene Adresse; sie prüft die Verbindung nicht.
Zertifikatsdetails finden
- Chrome / Edge: Öffnen Sie die Verbindungs- oder Zertifikatsdetails der Website (oder den Bereich Sicherheit des Browsers) und sehen Sie sich den SHA-256-Fingerabdruck des Zertifikats an.
- Firefox: Wählen Sie auf der Warnseite Erweitert → Zertifikat anzeigen und suchen Sie den SHA-256-Fingerabdruck.
- Safari: Wählen Sie Details einblenden → Zertifikat anzeigen und klappen Sie die Angaben zum Fingerabdruck auf. Die Bezeichnungen können je nach Browserversion abweichen.
- Stimmen die Fingerabdrücke nicht überein, brechen Sie ab und prüfen Sie die Adresse des GX, bevor Sie ein Passwort eingeben.
6. Einrichtung abschließen
- Wählen Sie im Einrichtungsassistenten einen lokalen Phaeton-Benutzernamen und ein Passwort. Diese sind unabhängig von Ihrem Root-Passwort des GX.
- Wählen Sie die Integration Ihrer Wallbox und geben Sie deren Verbindungsdaten ein. Schließen Sie die GX-Verbindungseinstellungen für die gewünschte Integration nach den Hinweisen des Assistenten ab. Optionale Verbindungseinstellungen können Sie später erledigen.
- Speichern Sie, melden Sie sich bei Phaeton an und schließen Sie die Aktivierung mit Ihrem Konto im Phaeton-Portal ab. Dieses Konto verwaltet die Lizenz; es ist unabhängig von der Phaeton-Anmeldung und dem VRM-Konto. Folgen Sie einer eventuellen Aufforderung zum Neustart.
- Prüfen Sie das Dashboard, die Verbindung zur Wallbox und die gewünschte GX-Integration. Starten Sie einen Ladetest erst, wenn Sie bereit sind und die Wallbox richtig konfiguriert ist.
Nutzen Sie für künftige Updates „Software Updates“ in Phaeton. Sobald alles läuft, können Sie „SSH on LAN“ wieder ausschalten, wenn Sie es nicht mehr brauchen. Lassen Sie „Modifications enabled“ eingeschaltet, damit Phaeton beim Hochfahren des GX mitstartet.
Andere Linux-Geräte und erweiterte Downloads
Der GX-Installer wählt sein Paket automatisch. Für ein anderes Linux-System folgen Sie der Linux-Anleitung. Manuelle Installationsarchive und signierte .phaeton-update-Pakete sind unterschiedliche Dateien; für ein installiertes Phaeton nutzen Sie „Software Updates“.