Skip to content

Installation

Stefan Apetz edited this page Nov 13, 2026 · 3 revisions

Installation

Diese Anleitung installiert den stabilen Stand aus main. Die Befehle gehören in die FHEM-Befehlszeile, nicht in ein Betriebssystemterminal.

1. Voraussetzungen prüfen

Lies Voraussetzungen und Sicherheit. Erstelle eine vollständige Sicherung deiner FHEM-Installation.

Empfehlung: WebSockets für zeitnahe Live-Werte

Für möglichst unmittelbare Wertaktualisierungen empfehlen wir eine nutzbare WebSocket-Verbindung zum FHEMWEB-Inform-Endpunkt. Das CMS öffnet diese Verbindung selbst (ws:// bei HTTP, wss:// bei HTTPS). Ein Reverse Proxy muss WebSocket-Upgrades und langlebige Verbindungen zum FHEMWEB-Endpunkt weiterleiten.

WebSockets sind keine Pflichtvoraussetzung: Ohne diese Verbindung bleibt das CMS bedienbar und liest Gerätewerte alle 30 Sekunden per HTTP-Polling neu ein. Laden, Speichern und Gerätebefehle laufen über HTTP-Anfragen. Dieses Polling ist kein FHEMWEB-Longpoll; eine vorhandene Longpoll-Einstellung allein erfordert deshalb keine Umstellung von FHEMWEB.

Nach dem Öffnen des CMS kannst du die Verbindung in den Browser-Entwicklerwerkzeugen unter Netzwerk → WS prüfen: 101 Switching Protocols bestätigt den WebSocket-Verbindungsaufbau. Fehlt die Verbindung, Proxy, Anmeldung und Verbindung prüfen; den FHEMWEB-Zugriffsschutz nicht abschalten.

2. Updatequelle hinzufügen und Dateien laden

update add https://raw.githubusercontent.com/stapetz/fhem-cms/main/controls_fhem-cms.txt
update all https://raw.githubusercontent.com/stapetz/fhem-cms/main/controls_fhem-cms.txt
shutdown restart

Die Updateadresse zeigt bewusst auf eine Controls-Datei, nicht direkt auf eine .pm-Datei. Sie installiert das Modul und die zusammengehörigen Frontenddateien. update add registriert die Quelle; update all lädt sie. shutdown restart startet FHEM neu und unterbricht es entsprechend kurz.

3. CMS-Device anlegen

Nach dem Neustart:

define CMS fhemcms

CMS ist ein Beispielname. Wähle bei Bedarf einen anderen Namen und verwende ihn in allen folgenden Befehlen. Erlaubt sind Buchstaben, Ziffern, Punkt, Unterstrich und Bindestrich.

Das Device erscheint standardmäßig im Raum FHEM CMS. Die FHEM-Konfiguration anschließend wie üblich speichern.

4. Oberfläche öffnen

Einstieg am Device Zweck
CMS starten Bearbeitungsmodus öffnen.
Zeige Homepage Veröffentlichten Stand öffnen.
get CMS url Relativen Pfad zur Homepage anzeigen.

Die Einbindung erfolgt unter deinem FHEMWEB-Pfad. Bei einem üblichen Webnamen fhem und Device CMS ist das beispielsweise:

/fhem/fhem-cms/CMS/index.html
/fhem/fhem-cms/CMS/index.html?mode=edit

Host, Port, FHEMWEB-Webname und Device hängen von deiner Installation ab. Verwende bevorzugt die erzeugten Device-Links.

5. Ergebnis kontrollieren

  • Das Device ist ohne Modul-Ladefehler definiert.
  • Der Editor öffnet sich.
  • Ein neues Device beginnt in Schema 5 mit 12 Spalten.
  • Die installierte Modulversion steht im Internal VERSION des Devices.
  • Empfohlen: Die WebSocket-Verbindung ist unter Netzwerk → WS sichtbar. Ohne WebSocket bleiben Live-Werte mit HTTP-Polling im 30-Sekunden-Takt verfügbar.

Vorhandene alte Daten werden nicht automatisch durch eine neue Startkonfiguration ersetzt. Wird eine fehlende oder beschädigte Konfiguration gemeldet, zuerst Sicherung und Pfade prüfen, nicht durch wiederholtes Definieren überschreiben.

Weiter: Erste Schritte · Updates

Clone this wiki locally