Accountant: Inventar, where, Checkmk, Abrechnung

deploy/compose/agent/.env.example

@@ -1,10 +1,23 @@
+# sultan agent – Einstellungen für compose.yaml (cp .env.example .env).
+# Jede Variable SULTAN_<FLAG> entspricht dem Flag --<flag> (sultan agent --help);
+# leer oder auskommentiert = Default (rechts angegeben).
+
 # Image: lokal gebaut (docker build -t sultan:latest .) oder aus der Registry
-# SULTAN_IMAGE=sultan:latest
-# SULTAN_IMAGE=zot.chmln.de/sultan:v0.1.0
 SULTAN_IMAGE=zot.chmln.de/sultan:latest
 
 # Einladung vom Server: docker compose exec sultan-server sultan token invite --tenant=…
+# Nach dem ersten Start nicht mehr nötig; stehen lassen ist harmlos.
 SULTAN_TOKEN=
 
-# Gruppe des Docker-Sockets: getent group docker | cut -d: -f3
+# Gruppe des Docker-Sockets (Pflicht): getent group docker | cut -d: -f3
 DOCKER_GID=
+
+# Optional
+# SULTAN_SERVER=https://ingress.example.de:8443   # Default: Adresse aus der Einladung
+# SULTAN_NODE_ID=webdocker11                      # Default: aus dem Hostnamen
+# SULTAN_BACKEND_HOST=10.0.0.11                   # Default: automatisch (Route zum Server)
+# SULTAN_BACKEND_INTERFACE=wt0                    # alternativ: IP dieses Interfaces (NetBird)
+# SULTAN_FQDN=webdocker11.lan.example.de          # Default: per DNS ermittelt (nur Inventar)
+
+# Zeitzone für Zeitstempel im Log (ohne TZ: UTC)
+TZ=Europe/Berlin

deploy/compose/agent/compose.yaml

@@ -16,11 +16,8 @@ services:
     restart: unless-stopped
     network_mode: host
     command: ["sultan", "agent", "--data-dir=/suldata", "--config-dir=none"]
-    environment:
-      # Ausgabe von `sultan token invite`; nach dem ersten Start nicht mehr nötig,
-      # stehen lassen ist harmlos.
-      SULTAN_TOKEN: ${SULTAN_TOKEN:-}
-      TZ: ${TZ:-Europe/Berlin}  # Zeitstempel im Log
+    # Alle Einstellungen kommen aus .env (Vorlage mit Defaults: .env.example).
+    env_file: .env
     # Lesezugriff auf den Docker-Socket für den nonroot-User (UID 65532).
     group_add:
       - "${DOCKER_GID:?DOCKER_GID setzen: getent group docker | cut -d: -f3}"