Repository navigation
Installation
Diese Anleitung installiert den stabilen Stand aus main.
Die Befehle gehören in die FHEM-Befehlszeile, nicht in ein Betriebssystemterminal.
Lies Voraussetzungen und Sicherheit. Erstelle eine vollständige Sicherung deiner FHEM-Installation.
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.
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.
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.
| 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.
- 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
fhem-cms · Anwenderhandbuch für 1.6.1 / Schema 5 · Stand 10.11.2026
- Idee und Funktionsumfang
- Voraussetzungen und Sicherheit
- Installation
- Updates und Versionen
- Erste Schritte
- Editor und Veröffentlichen
- Seiten und Navigation
- Theme-Manager und Hintergrundbilder
- Layout und mobile Ansicht
- Widgetübersicht
- Anrufliste
- Wert, Uhr und Status
- Thermostat und Steuerung
- Tabelle, Diagramm, SolarFlow
- VolvoConnect: Fahrzeug und Modul
- Text und Bilder
- Platzhalter und HTML
- LinkWidget
- Assetmanager