EnergyOS vereint zwei Aufgaben: die Fernverwaltung Ihrer Energiesysteme und die Verwaltung der Geräte, die alles verbinden. Diese Anleitung erklärt, was jeder Teil leistet, wie die Teile miteinander sprechen und wie Sie sie einrichten.
Erste Schritte
- Legen Sie ein Konto an und melden Sie sich an. Der Gratis-Tarif braucht keine Kreditkarte.
- Fügen Sie Ihre Energiesysteme hinzu unter Energiemanagement aus der Ferne → Energiesysteme (Wärmepumpe, PV, Batterie, Ladestation) oder erstellen Sie zuerst Demo-Systeme zum Ausprobieren.
- Verbinden Sie ein Gerät unter Geräteverwaltung → Gerät hinzufügen. Es führt den EnergyOS-Agenten neben Ihren Systemen aus und meldet deren Status (siehe den Agenten).
- Verknüpfen Sie jedes System mit seinem Gerät. Die Übersicht zeigt dann, ob es online ist.

Wie EnergyOS zusammenspielt
EnergyOS spricht nie direkt mit Ihren Anlagen. Ein kleines Programm bei Ihnen vor Ort, das Gateway oder der Agent, spricht mit den Anlagen und hält eine ausgehende, verschlüsselte Verbindung zum EnergyOS-Message-Broker. Alles Weitere läuft über diese Verbindung.
| Teil | Wo es läuft | Was sie tut |
|---|---|---|
| Anlagen | Bei Ihnen vor Ort | Wärmepumpe, PV-Wechselrichter, Batterie, Ladestation, Zähler, Sensoren. Spricht ein eigenes Protokoll (Modbus, OCPP, KNX, Matter, eine Hersteller-API). |
| Gateway | Bei Ihnen vor Ort: ein Raspberry Pi, Mini-PC, NAS oder Server | Übersetzt zwischen dem Protokoll der Anlage und EnergyOS-Nachrichten. Home Assistant, evcc, Node-RED, zigbee2mqtt oder ein kleines Skript können alle das Gateway sein. |
| EnergyOS-Agent | Auf einem Linux-Gerät bei Ihnen vor Ort | Meldet den Zustand des Geräts (CPU, Speicher, Festplatte, Temperatur), führt Netzwerktests aus und führt Befehle aus, die Sie von der Seite senden. |
| MQTT-Broker | QLines | Nimmt Nachrichten entgegen und verteilt sie. Jedes Gerät hat seinen eigenen Zugang und darf nur seine eigenen Topics nutzen. |
| EnergyOS | QLines | Zeigt die Daten, sendet Befehle, führt Regeln und Alarme aus und zeigt die Wetterprognose und die Strompreise. |
Was brauche ich? Um Energiesysteme zu lesen und zu steuern, brauchen Sie ein Gateway, das MQTT spricht (siehe Anlagen verbinden). Um einen Computer zu beobachten und zu verwalten (Status, Diagramme, Netzqualität, Fernbefehle), installieren Sie den Agenten (siehe Der Agent). Ein Gerät kann beides: Der Agent und Home Assistant können nebeneinander auf demselben Raspberry Pi laufen.
Energiemanagement aus der Ferne
Ein Energiesystem ist ein Anlagenteil: Wärmepumpe, PV-Anlage, Batterie, Ladestation, Heizkessel, Energiezähler. Zu jedem geben Sie einen Namen, den Typ, die Nennleistung, die Anbindung und das Gerät (das Gateway) an, mit dem es verknüpft ist.
- Übersicht: eine Kachel pro System mit seinem Hauptwert und einem Live-/Keine-Daten-Status. Melden PV, ein Netzzähler oder eine Batterie Werte, wird der Energiefluss gezeigt: PV, Netz (Bezug oder Einspeisung), Batterie, Hausverbrauch und der Anteil, den Sie selbst decken.
- Systemseite: alle aktuellen Werte, ein Verlaufsdiagramm (6 Stunden, 24 Stunden, 7 Tage, jeder Kanal), Steuerungen und die Liste der letzten Befehle.
- Demo-Systeme: Demo-Systeme erstellen legt fünf Systeme mit zwei Tagen simulierter Messwerte und simulierten Befehlen an, zum Ausprobieren oder für ein Video.



Steuerungen
Die Steuerungen hängen vom Typ ab. Wärmepumpe: Betriebsart (gesperrt, normal, Einschaltempfehlung, Zwangsbetrieb, wie bei SG Ready), Warmwasser-Solltemperatur, Leistungsgrenze. Ladestation: Laden erlaubt, Stromgrenze, Leistungsgrenze. Batterie: Modus, maximale Ladeleistung. PV: Einspeisegrenze. Heizkessel: Vorlauftemperatur-Sollwert.

Anlagen verbinden (MQTT)
EnergyOS spricht MQTT. Ein Gateway steht neben Ihrer Anlage, spricht deren eigenes Protokoll und tauscht flache JSON-Nachrichten mit EnergyOS aus. Jedes Programm, das MQTT spricht, kann das Gateway sein: Home Assistant, Node-RED, evcc, zigbee2mqtt, ein Matter-Server oder ein kleines Skript. Nutzen Sie den MQTT-Zugang des Geräts, mit dem das System verknüpft ist: Die Geräte-ID ist der Benutzername und der Geräte-Token das Passwort, über TLS auf Port 8883 (Server mqtt.qlines.net).
publish rc/{account}/{device}/energy/{system_id} {"power_w": 4200, "soc_pct": 63}
listen rc/{account}/{device}/energy/{system_id}/set {"cmd_id": "...", "control": "mode", "value": "eco"}
confirm rc/{account}/{device}/energy/{system_id}/ack {"cmd_id": "...", "ok": true, "message": ""}
Die Systemseite zeigt diese Topics mit Ihren echten IDs. Messwerte sind nur Zahlen (bis zu 40 Kanäle pro Nachricht), werden höchstens alle 10 Sekunden gespeichert und 90 Tage aufbewahrt; sie zählen zum täglichen Nachrichtenlimit des Geräts.
| Kanal | Bedeutung |
|---|---|
power_w | Leistung in W (Batterie: positiv beim Laden) |
grid_w | Netzzähler: positiv = Bezug, negativ = Einspeisung |
soc_pct | Ladezustand der Batterie in % |
temp_flow_c, temp_return_c, temp_outdoor_c, temp_dhw_c, cop | Wärmepumpenwerte |
energy_kwh, energy_import_kwh, energy_export_kwh | Zähler in kWh |
grid_limit_active | 1, solange der Netzbetreiber steuerbare Geräte begrenzt (§14a EnWG) |
Protokolle
Sie wählen, wie ein System angebunden ist, damit die Einrichtung dokumentiert ist. EnergyOS selbst spricht MQTT; das Gateway übersetzt:
| Die Anlage spricht | Gateway |
|---|---|
| Modbus TCP / SunSpec (Wechselrichter, Batterien, Zähler) | Home Assistant, evcc, Node-RED oder eine MQTT-Option des Herstellers |
| OCPP (Ladestationen) | evcc oder die eigene MQTT-Schnittstelle der Ladestation |
| EEBUS, SG Ready (Wärmepumpen) | Home Assistant oder das Gateway der Wärmepumpe; SG Ready sind zwei Relaiskontakte |
| KNX, Matter / Thread, Zigbee / Z-Wave (Sensoren, Schalter, Steckdosen) | Home Assistant (KNX, Matter) oder zigbee2mqtt, beide veröffentlichen auf MQTT |
| Hersteller-Cloud oder HTTP-API | Ein kleines Skript oder ein Node-RED-Flow |
EnergyOS spricht nicht selbst mit den Anlagen. Bestätigt ein Gateway einen Befehl nicht, zeigt die Seite keine Bestätigung, und die Einstellung gilt nicht als übernommen.
Wetterprognose
Geben Sie auf der Energieseite einmal den Standort Ihrer Systeme ein (Ort, Postleitzahl oder Adresse). EnergyOS lädt dann die Wettervorhersage für die nächsten 48 Stunden: die MOSMIX-Prognose des Deutschen Wetterdienstes (DWD) für den nächstgelegenen Prognosepunkt, über den Dienst Bright Sky: Außentemperatur, Sonneneinstrahlung und Bewölkung, stündlich aktualisiert. Daraus zeigt EnergyOS:
- Kälteste und wärmste Stunde der nächsten 24 Stunden.
- Erwarteter PV-Ertrag: Sonneneinstrahlung × installierte kWp Ihrer PV-Systeme × 80 % Performance Ratio. Eine einfache Schätzung ohne Dachneigung und Ausrichtung, gut genug, um einen sonnigen Tag von einem grauen zu unterscheiden.
- Heizbedarf: Gradstunden unter 15 °C Außentemperatur. Mehr Gradstunden bedeuten mehr benötigte Wärme.
- PV heute, erwartet gegenüber gemessen: die Prognoseenergie seit Mitternacht neben der Energie, die Ihre PV-Systeme gemeldet haben. Deutlich unter der Prognose (unter 70 %) deutet auf Verschattung, Verschmutzung oder einen Fehler hin.

Die Prognose steuert auch zwei Regeln unter Automatisierung (siehe unten). Demo-Systeme verwenden München als Standort; ihre PV-Messwerte sind simuliert, daher wird die Zeile „erwartet gegenüber gemessen“ nur für echte PV-Systeme angezeigt.
Automatisierung und Preise
Unter Automatisierung sehen Sie den deutschen Day-Ahead-Strompreis für die nächsten Stunden: jetzt, niedrigster, höchster und das günstigste 3-Stunden-Fenster. Der Preis ist der Marktpreis ohne Steuern, Netzentgelte und Lieferantenmarge: gut zum Vergleichen von Stunden, keine Rechnung. Er kommt von aWATTar, mit Energy-Charts als Ausweichquelle.

Regeln schalten eine Steuerung, wenn eine Bedingung beginnt, und stellen sie zurück, wenn sie endet. Eine Regel ändert höchstens alle 5 Minuten. Verfügbare Regeln:
- PV-Überschuss für die Wärmepumpe nutzen: Exportiert der Netzzähler mehr als die Schwelle, wird die Wärmepumpe auf empfohlen ein gestellt; danach zurück auf normal.
- Das Auto mit PV-Überschuss laden: Laden erlauben, solange der Überschuss anhält.
- Warmwasser heizen, wenn Strom günstig ist: Zwangsbetrieb, solange der Marktpreis unter der Schwelle liegt (ct/kWh).
- Vor einer Kältewelle vorheizen (Wetterprognose): Liegt die niedrigste für die nächsten 12 Stunden vorhergesagte Außentemperatur an oder unter der Schwelle (°C), wird die Wärmepumpe auf empfohlen ein gestellt, damit das Gebäude Wärme speichert, bevor die Kälte kommt; danach zurück auf normal.
- Warmwasser der Sonne überlassen, wenn ein sonniger Tag vorhergesagt ist: Erreicht die PV-Ertragsprognose für die nächsten 24 Stunden die Schwelle (kWh), wird die Warmwasser-Solltemperatur auf 45 °C gesenkt, damit die Sonne es später erwärmen kann; sonst 55 °C. Braucht mindestens ein PV-System mit seiner kWp-Angabe.
- Netzbetreiber-Begrenzung (§14a EnWG): Meldet das Gateway
grid_limit_active= 1, werden Wärmepumpen und Ladestationen auf 4,2 kW begrenzt; die Begrenzung wird aufgehoben, wenn das Signal endet.

Regeln brauchen Daten: Eine Regel, die die benötigten Werte nicht sieht, tut nichts (zum Beispiel eine Prognoseregel ohne Standort oder Prognose). Sie können jede Regel pausieren oder löschen.
Förderrechner für Wärmepumpen
Die Bundesförderung für eine Wärmepumpe in Deutschland (BEG EM, ausgezahlt von KfW und BAFA) ist nicht Teil des EnergyOS-Dashboards. Es ist ein kostenloser Rechner auf qlines.net, der kein Konto braucht und nichts speichert: Wärmepumpen-Förderrechner für Deutschland.
Nur für Deutschland. Der Rechner nutzt das deutsche Bundesprogramm und gilt für Gebäude in Deutschland. Förderungen in anderen Ländern folgen anderen Regeln.

Sie geben die Gebäudeart, das Antragsdatum, die Heizung, die Sie ersetzen, und ihr Alter, ob Sie selbst im Gebäude wohnen, Ihr Haushaltseinkommen und die geplanten Kosten ein (oder die Wärmepumpengröße für eine Kostenschätzung). Sie erhalten den Fördersatz, wie er sich aus Grundförderung und Boni zusammensetzt, die höchste Förderung, Ihren Eigenanteil und, wenn Sie Ihren Brennstoffverbrauch angeben, die jährliche Ersparnis und die Amortisation.
Das Ergebnis ist eine Schätzung mit den veröffentlichten Regeln, kein Förderbescheid. Über den Antrag entscheiden KfW (private Eigentümer) oder BAFA.
Geräteverwaltung aus der Ferne
Fügen Sie ein Gerät hinzu, um Status, Verbindungsqualität, Netzwerktests und Fernbefehle zu erhalten. Die Flottenübersicht zeigt alle Geräte auf einen Blick: wie viele es im Vergleich zu Ihrem Tarif sind, wie viele online und offline sind und wie viele Alarme offen sind. Jede Karte zeigt den Status, wann das Gerät zuletzt gesehen wurde, CPU-, Speicher- und Festplattenauslastung und den letzten Ping. Mit Filterfeld und Sortiermenü finden Sie ein Gerät.

Status und zuletzt gesehen
Zuletzt gesehen sagt, wie lange das Gerät zuletzt gemeldet hat, zum Beispiel vor 5 Min. oder vor 3 Tagen, und aktualisiert sich selbst, solange die Seite offen ist. Fahren Sie mit der Maus darüber, um die genaue Zeit in Ihrer Zeitzone zu sehen. Unter einer Minute steht gerade eben; nach einem Tag wird der Text bernsteinfarben, damit ein vergessenes Gerät auffällt.
Die Geräteseite
- Übersicht: aktuelle CPU, Speicher, Festplatte und Temperatur sowie die Systemdetails: Geräte-ID, Hostname, Betriebssystem, Architektur, Agent-Version, Registrierungsdatum, zuletzt gesehen und Betriebszeit.
- Telemetrie: Diagramme für CPU, Speicher, Festplatte und Temperatur für 1 Stunde, 6 Stunden, 24 Stunden oder 7 Tage.
- Befehle: Führen Sie einen Befehl auf dem Gerät aus und sehen Sie das Ergebnis (siehe Fernbefehle).
- Netzwerktests: Ping, Download- und Upload-Geschwindigkeit, DNS-Abfragezeit und HTTP-Prüfungen, nach Zeitplan oder auf Abruf mit Test jetzt ausführen.
- Einstellungen: Name und Notizen, das Heartbeat-Intervall (15, 30 oder 60 Sekunden), das Telemetrie-Intervall (30 Sekunden bis 15 Minuten), der Zeitplan der Netzwerktests und die aktivierten Funktionen. Speichern und Refresh Config senden die neuen Einstellungen an den Agenten.



Alarme
EnergyOS öffnet einen Alarm, wenn ein Wert seine Schwelle überschreitet. Offene Alarme werden an der Glocke oben rechts und auf der Flottenübersicht gezählt. Ein Alarm schließt sich von selbst, wenn der Wert wieder normal ist.
| Alarm | Öffnet sich, wenn |
|---|---|
| Gerät offline | Kein Heartbeat seit 2 Minuten |
| Hohe CPU-Last | CPU über 90 % |
| Hohe Temperatur | Temperatur über 80 °C |
| Hohe Festplattenauslastung | Festplatte über 90 % |
| Hohe Latenz | Ping-Durchschnitt über 200 ms im letzten Netzwerktest |
| Paketverlust | Jeder Paketverlust im letzten Netzwerktest |
Alarme erscheinen in der App. E-Mail-Benachrichtigungen sind standardmäßig aus; kontaktieren Sie uns, wenn Sie sie für Ihr Konto möchten.
Der Agent: Installation und Voraussetzungen
Der EnergyOS-Agent ist ein kleines Python-Programm für Linux-Geräte (Raspberry Pi, Mini-PCs, Server). Er hält eine ausgehende MQTT-Verbindung zu EnergyOS, meldet den Zustand des Geräts und führt die Netzwerktests und Befehle aus, die Sie von der Seite starten. Zum Anbinden von Energieanlagen wird er nicht gebraucht; das ist die Aufgabe des Gateways (siehe Wie EnergyOS zusammenspielt).
Voraussetzungen
| Was | Erforderlich |
|---|---|
| Betriebssystem | Linux. systemd wird empfohlen, um ihn als Dienst auszuführen. Raspberry Pi OS, Debian und Ubuntu sind die üblichen Wahlen; ARM und x86 funktionieren beide. |
| Python | Version 3.9 oder neuer |
| pip | Wird vom Installer installiert, falls es fehlt (über apt, dnf, yum, pacman, apk oder das offizielle get-pip-Skript) |
| Bibliotheken | paho-mqtt, psutil, PyYAML, speedtest-cli, requests und schedule. Der Installer holt sie. |
| Rechte | Keine, wenn Sie als eigener Benutzer installieren und ausführen. sudo nur für rc-agent install-service und, falls gewünscht, zum Installieren von pip. |
| Netzwerk | Nur ausgehend: HTTPS (Port 443) zu www.qlines.net für die Installation und das einmalige init, danach MQTT über TLS (Port 8883) zu mqtt.qlines.net. pip erreicht außerdem PyPI. Die Uhr muss stimmen, sonst schlägt die TLS-Prüfung fehl. |
| Für die Netzwerktests | Der Befehl ping und ausgehender Zugriff auf 8.8.8.8, google.com und cloudflare.com |
| Größe | Ein leichter Hintergrundprozess; ein Raspberry Pi reicht völlig aus |
Installation
- Wählen Sie in EnergyOS Gerät hinzufügen, geben Sie ihm einen Namen und registrieren Sie es. Kopieren Sie den Token; er wird einmal angezeigt.
- Führen Sie auf dem Gerät den Installer mit Ihrem Token aus:
curl -sSL https://www.qlines.net/install/rc-agent | bash -s -- --token tok_xxxxxxxx - Den Agenten starten:
rc-agent start - Damit der Agent nach dem Abmelden und nach einem Neustart weiterläuft, installieren Sie ihn als Dienst:
sudo rc-agent install-service sudo systemctl start remotecontrol-agent

Unter Debian 12 und Raspberry Pi OS ist das System-Python „extern verwaltet“. Der Installer fügt dann die pip-Option --break-system-packages hinzu. Wenn Sie den Agenten getrennt halten möchten, legen Sie zuerst eine virtuelle Umgebung an (python3 -m venv ~/rc-agent-env), installieren Sie das Paket mit dem pip dieser Umgebung hinein (https://www.qlines.net/install/remotecontrol-agent.tar.gz) und starten Sie ~/rc-agent-env/bin/rc-agent.
Was wo installiert wird
| Was | Wo |
|---|---|
Befehl rc-agent | ~/.local/bin (Benutzerinstallation) oder /usr/local/bin (als root installiert) |
| Python-Paket und Bibliotheken | Der Ordner site-packages des Python, das der Installer verwendet hat |
| Einstellungen (ID, Token, Server) | ~/.config/remotecontrol/config.yaml; als Dienst /etc/remotecontrol/config.yaml (nur für den Dienstbenutzer lesbar) |
| Dienst | /etc/systemd/system/remotecontrol-agent.service, läuft als Systembenutzer remotecontrol (ohne Login, ohne Home-Verzeichnis) |
| Marker für den laufenden Prozess | /tmp/remotecontrol-agent.pid |
| Protokoll | Das Terminal; als Dienst journalctl -u remotecontrol-agent |
Die Einstellungsdatei enthält den Geräte-Token im Klartext. Schützen Sie sie: chmod 600 ~/.config/remotecontrol/config.yaml. Wird ein Token offengelegt, nutzen Sie Regenerate Token in den Geräteeinstellungen: Der alte funktioniert dann nicht mehr.
Was Agent und EnergyOS einander sagen
Alle Nachrichten sind kleine JSON-Dokumente auf Topics unter rc/{account}/{device}/. Der Agent beginnt jedes Gespräch: Er verbindet sich, abonniert drei Topics (config, cmd/request, nettest/trigger) und veröffentlicht, was er hat. EnergyOS antwortet auf den Topics, auf die der Agent lauscht.
Topic (unter rc/{account}/{device}/) | Richtung | Inhalt |
|---|---|---|
register | Agent → EnergyOS | Agent-Version, Hostname, System, Architektur, Python-Version |
config | EnergyOS → Agent | Heartbeat- und Telemetrie-Intervall, aktivierte Funktionen, Zeitplan der Netzwerktests |
heartbeat | Agent → EnergyOS | „Noch da“, standardmäßig alle 30 Sekunden |
telemetry/system | Agent → EnergyOS | CPU, Speicher, Festplatte, Temperatur, Betriebszeit, Last; standardmäßig alle 60 Sekunden |
nettest/trigger und nettest/result | beide | Einen Netzwerktest jetzt starten; sein Ergebnis (Ping, DNS, HTTP-Prüfungen, Geschwindigkeit) |
cmd/request und cmd/response | beide | Der auszuführende Befehl; seine Ausgabe, Fehlertext, Exit-Code und Dauer |
Befehle des Agenten
| Befehl | Was sie tut |
|---|---|
rc-agent init --token … --server mqtt.qlines.net | Prüft den Token bei EnergyOS und schreibt die Einstellungsdatei |
rc-agent start | Führt den Agenten im Vordergrund aus |
rc-agent status | Zeigt, ob er läuft, und eine Zusammenfassung der Einstellungen |
rc-agent test-nettest | Führt einen Netzwerktest aus und gibt das Ergebnis aus |
sudo rc-agent install-service | Legt den Dienstbenutzer an, kopiert die Einstellungen nach /etc/remotecontrol und installiert und aktiviert den systemd-Dienst |
Den Agenten entfernen
- Den Dienst stoppen und entfernen, falls Sie ihn installiert haben:
sudo systemctl disable --now remotecontrol-agentund/etc/systemd/system/remotecontrol-agent.servicelöschen. python3 -m pip uninstall remotecontrol-agentund löschen Sie den Einstellungsordner.- Löschen Sie das Gerät in EnergyOS. Dadurch wird auch sein Zugang beim Broker entfernt.
Fernbefehle
Auf dem Reiter Befehle eines Geräts können Sie einen Befehl auf dem Gerät ausführen und die Antwort lesen. Befehle laufen über den Agenten, nur solange das Gerät online ist, und jeder Befehl wird protokolliert: wer ihn gesendet hat, wann, Exit-Code und Dauer.

Wie ein Befehl abläuft
Der Agent startet keine Shell. Er zerlegt Ihren Text wie eine Shell in Wörter (Anführungszeichen funktionieren) und startet das Programm direkt, als der Benutzer, unter dem der Agent läuft. Das ist sicherer und erklärt, warum nur manches so funktioniert, wie es getippt wird.
| Sie geben ein | Ergebnis |
|---|---|
df -h /, uname -a, uptime | Funktioniert: ein Programm und seine Argumente |
df -h | head -2, a && b, ls > file, ls *.log | Funktioniert so nicht: Pipes, &&, Umleitungen und Platzhalter gehören zu einer Shell |
cd /tmp, export X=1, echo $HOME | Funktioniert nicht: Das sind Shell-Befehle und Variablenersetzungen |
/bin/bash -c 'df -h | head -2' | Funktioniert: Sie fordern selbst eine Shell an, und sie führt die ganze Zeile aus |
sudo reboot | Funktioniert nur, wenn der Benutzer des Agenten es ohne Passwort ausführen darf (siehe unten) |
| Ein Programm, das auf Eingaben wartet oder länger als 30 Sekunden läuft | Nach 30 Sekunden gestoppt, zusammen mit allem, was es gestartet hat. Die Eingabe ist geschlossen, daher kann nichts eine Frage stellen. |
| Eine sehr lange Ausgabe | Bei 64.000 Zeichen pro Strom abgeschnitten, mit einem Hinweis |
Kurz gesagt: Ein Befehl nutzt den eigenen Benutzer und die Umgebung des Agenten. Als Dienst ist das der Benutzer remotecontrol mit einem minimalen PATH und ohne Login-Profil.
Um Ihre eigene Umgebung zu nutzen, führen Sie /bin/bash -lc '…' für eine Login-Shell aus, rufen Sie Programme mit ihrem vollen Pfad auf (zum Beispiel dem Pfad venv/bin/python) oder fügen Sie dem Dienst Environment=-Zeilen hinzu.
Welche Umgebung ein Befehl sieht
Ein Befehl läuft als der Benutzer, unter dem der Agent läuft, mit der Umgebung des Agent-Prozesses: dessen PATH, dessen HOME, dessen Arbeitsordner und dessen Variablen. Er liest weder .bashrc noch .profile, weil keine Login-Shell beteiligt ist.
- Von Hand gestartet (
rc-agent start): die Umgebung dieses Terminals, einschließlich einer aktivierten virtuellen Umgebung. - Als Dienst gestartet (
install-service): der Systembenutzerremotecontrolmit der minimalen Umgebung, die systemd einem Dienst gibt (ein kurzerPATHwie/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin). Er ist nicht Ihr Login-Benutzer, hat kein Home-Verzeichnis und ist nicht in der Gruppesudo.
Die eigene Umgebung nutzen
| Sie möchten | Tun Sie dies |
|---|---|
| Um zu sehen, was der Agent sieht | Führen Sie env und whoami als Befehle aus |
Ihre Login-Umgebung (.profile, Ergänzungen von PATH) | /bin/bash -lc 'your command' (eine Login-Shell des Agent-Benutzers) |
| Ein Programm aus einer virtuellen Umgebung | Geben Sie den vollen Pfad an: /home/pi/venv/bin/python /home/pi/check.py |
| Dauerhafte Variablen für jeden Befehl | Als Dienst: sudo systemctl edit remotecontrol-agent, [Service] und Environment="NAME=value" hinzufügen (oder EnvironmentFile=/etc/remotecontrol/env), dann den Dienst neu starten. Von Hand: vor rc-agent start setzen. |
| Befehle als anderer Benutzer | Lassen Sie den Agenten unter diesem Benutzer laufen (User= im Dienst ändern) oder erlauben Sie genau die benötigten Befehle mit einer sudoers-Regel für den Benutzer remotecontrol |
| Ein Neustart des Geräts | Die Schaltfläche Reboot Agent sendet sudo reboot. Erlauben Sie es mit einer sudoers-Datei wie remotecontrol ALL=(root) NOPASSWD: /usr/sbin/reboot, /usr/bin/systemctl reboot |
Jeder, der sich in Ihrem EnergyOS-Konto anmelden kann, kann auf jedem Gerät darin Befehle ausführen. Geben Sie dem Benutzer des Agenten nur die nötigen Rechte, machen Sie ihn nie aus Bequemlichkeit zu root und schützen Sie das Konto mit einem starken Passwort.
Sicherheit und Datenschutz
- Verschlüsselt: Der gesamte MQTT-Verkehr nutzt TLS (Port 8883), und der Agent prüft das Zertifikat des Servers. Die Website und die einmalige Token-Prüfung des Agenten nutzen HTTPS.
- Ein Zugang pro Gerät: Die Geräte-ID ist der Benutzername und der Token das Passwort. Ein Gerät kann nur auf seinen eigenen Topics veröffentlichen und lauschen, daher kann kein Gerät ein anderes lesen oder steuern.
- Keine eingehenden Verbindungen: Die Anlagen bleiben hinter Ihrem Router. Gateway und Agent verbinden sich nach außen.
- Tokens: werden bei EnergyOS gehasht gespeichert. Ein verlorener oder offengelegter Token wird in den Geräteeinstellungen mit Regenerate Token ersetzt (der Agent trennt sich, bis er neu eingerichtet ist); beim Löschen eines Geräts wird sein Zugang sofort entfernt.
- Privat pro Konto: Energiesysteme, Messwerte, Geräte und Befehle gehören nur zu Ihrem Konto.
- Wetter und Ortssuche: An die Wetter- und Ortsdienste werden nur der eingegebene Ortstext und die daraus gefundenen Koordinaten gesendet; keine Kontodaten.
- Backups: Die Daten werden jede Nacht gesichert. Gelöschte Daten verschwinden mit dem Rotieren der Backups, innerhalb von sechs Monaten.
Konto, Tarife und Grenzen
Unter Einstellungen sehen Sie Ihren Tarif und wie viel davon Sie nutzen (Geräte und die heutigen Nachrichten), ändern Passwort und E-Mail-Adresse, vergleichen Tarife und können, wenn Sie möchten, Ihr Konto löschen.

| Was | Grenze |
|---|---|
| Geräte, Nachrichten pro Gerät und Tag, Datenaufbewahrung | Hängen von Ihrem Tarif ab; siehe Preise und die Tarifkarten in den Einstellungen |
| Energiesysteme pro Konto | 30 |
| Automatisierungsregeln pro Konto | 20 |
| Energiemesswerte | 1 pro System alle 10 s, 90 Tage gespeichert; Befehle 180 Tage gespeichert |
Die Daten werden jede Nacht gesichert.
Fragen und Fehlersuche
Ich habe mein Passwort vergessen. Was nun?
Wählen Sie auf der Anmeldeseite Passwort vergessen? und geben Sie Ihre E-Mail-Adresse ein. Der Link in der E-Mail ist eine Stunde gültig und funktioniert einmal. Angemeldet ändern Sie das Passwort unter Einstellungen → Passwort ändern. Ein neues Passwort meldet Sie auf allen anderen Geräten ab.
Wie ändere ich meine E-Mail-Adresse?
Unter Einstellungen → E-Mail-Adresse ändern, mit Ihrem aktuellen Passwort. Wir senden einen Link an die neue Adresse; sobald Sie ihn anklicken (innerhalb von 24 Stunden), melden Sie sich mit der neuen Adresse an, und alle E-Mails gehen dorthin. Die alte Adresse erhält eine Mitteilung. Geräte, Systeme und Daten bleiben wie sie sind, installierte Agenten brauchen keine Änderung.
Wie lösche ich mein Konto?
Unter Einstellungen → Konto löschen, mit Ihrem aktuellen Passwort. Alles wird sofort gelöscht: Geräte werden getrennt und entfernt, zusammen mit Energiesystemen, Messwerten, Regeln, Einstellungen und dem Aktivitätsprotokoll. Kopien in unseren Backups werden gelöscht, sobald die Backups rotieren, innerhalb von sechs Monaten. Ihr UtilityControl-Konto, falls Sie eines haben, ist getrennt.
Der Installer meldet „Python 3.9+ not found“.
Installieren Sie ein aktuelles Python 3 (sudo apt install python3 python3-pip auf Debian-basierten Systemen) und starten Sie den Installer erneut.
Der Agent startet, aber das Gerät bleibt „Nie verbunden“ oder „Offline“.
- Prüfen Sie das Protokoll (
journalctl -u remotecontrol-agent -foder das Terminal). „MQTT connect refused“ bedeutet, dass der Token nicht zu diesem Gerät passt: Nutzen Sie Regenerate Token in den Geräteeinstellungen und führen Sierc-agent initmit dem neuen Token erneut aus. - Prüfen Sie, ob das Gerät
mqtt.qlines.netauf Port 8883 (ausgehend) erreicht und ob seine Uhr stimmt. - Manche Firmennetzwerke blockieren Port 8883; bitten Sie den Netzwerkverantwortlichen, ihn ausgehend freizugeben.
Ein Befehl meldet „Executable not found“.
Das Programm liegt nicht im PATH des Agenten. Geben Sie den vollen Pfad an oder lesen Sie Die eigene Umgebung nutzen.
Eine Steuerung meldet „keine Bestätigung“.
Das Gateway hat nicht rechtzeitig geantwortet. Prüfen Sie, ob es läuft und auf dem Topic …/set dieses Systems lauscht und ob es auf …/ack veröffentlicht. EnergyOS nimmt nicht an, dass die Einstellung gewirkt hat.
Ist das Ergebnis des Förderrechners verbindlich?
Nein. Es ist eine Berechnung mit den veröffentlichten Regeln. Über die Bewilligung entscheiden KfW oder BAFA.
Die Förderregeln haben sich geändert. Was nun?
Die Regeln sind als Daten gespeichert und werden von uns aktualisiert; die Ergebnisseite zeigt das Datum der letzten Prüfung.