roborock/.env.example aktualisiert

roborock/.env.example

@@ -1,36 +1,33 @@
 # ==============================================================================
-# ROBOROCK LOCAL SERVER CONFIGURATION
+# ROBOROCK LOCAL SERVER - CORE CONFIGURATION
 # ==============================================================================
 
 # Deine Roborock Region (z.B. 'de', 'us', 'cn')
 ROBOROCK_REGION=de
 
-# Zeitzone des Servers für Zeitpläne und korrekte Logs
+# Zeitzone für Logs und Zeitpläne
 ROBOROCK_TIMEZONE=Europe/Berlin
 
-# Modus für die TLS-Verschlüsselung:
+# REVERSE PROXY MODUS (Wichtig: Muss exakt 'external_tls' heißen!)
-# - 'local_tls': Der Server generiert/nutzt eigene Zertifikate direkt im Container.
+# Schaltet das interne Zertifikats-Management ab.
-# - 'external': Ein vorgeschalteter Reverse Proxy übernimmt TLS/HTTPS (empfohlen).
+ROBOROCK_SERVER_LISTENER_MODE=external_tls
-ROBOROCK_LISTENER_MODE=external
 
-# Interne Ports, auf denen der Container lauscht.
+# Ports, auf denen die App im Container lauscht und die dein Proxy ansteuern muss:
-# Diese Ports musst du in deinem Reverse Proxy als Ziel (Upstream) eintragen!
+ROBOROCK_SERVER_HTTPS_PORT=8888
-ROBOROCK_INTERNAL_API_PORT=8888
+ROBOROCK_SERVER_MQTT_TLS_PORT=8883
-ROBOROCK_INTERNAL_MQTT_PORT=8883
 
-# Name des persistenten Docker-Volumes für die Datenbank und Configs
+# Name des Docker-Volumes für deine Datenbanken und Gerätedaten
 ROBOROCK_VOLUME_NAME=roborock_data
 
 # ==============================================================================
 # HEALTHCHECK CONFIGURATION
 # ==============================================================================
 
-# Protokoll für den internen Healthcheck im Container:
+# Im 'external_tls' Modus spricht der Server intern nur unverschlüsseltes HTTP.
-# - 'http'  -> Nutzen, wenn LISTENER_MODE=external (Server spricht intern unverschlüsselt)
+# Daher muss der Healthcheck zwingend auf 'http' stehen.
-# - 'https' -> Nutzen, wenn LISTENER_MODE=local_tls (Server verwaltet Zertifikate selbst)
 ROBOROCK_SERVER_HEALTHCHECK_SCHEME=http
 
-# Intervalle und Limits für den Docker Healthcheck
+# Intervalle für den Docker Healthcheck
 ROBOROCK_HEALTHCHECK_INTERVAL=30s
 ROBOROCK_HEALTHCHECK_TIMEOUT=5s
 ROBOROCK_HEALTHCHECK_RETRIES=5