From 00e1e88dd9c3409f2108ac4850bfbf8d44a335fd Mon Sep 17 00:00:00 2001
From: florianfederspiel <florian@fedeo.de>
Date: Mon, 18 May 2026 15:24:43 +0200
Subject: [PATCH] =?UTF-8?q?KI-AGENT:=20Lokalen=20Matrix-Entwicklungsstack?=
 =?UTF-8?q?=20erg=C3=A4nzen?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .env.example                   |  12 ++++
 .gitignore                     |   2 +
 docker-compose.yml             | 127 +++++++++++++++++++++++++++++++++
 matrix/README.md               |  78 ++++++++++++++++++++
 matrix/dev/element-config.json |  15 ++++
 5 files changed, 234 insertions(+)
 create mode 100644 matrix/dev/element-config.json

diff --git a/.env.example b/.env.example
index 3c9fd8e..c890760 100644
--- a/.env.example
+++ b/.env.example
@@ -16,3 +16,15 @@ MATRIX_TURN_SHARED_SECRET=change-this-turn-secret
 
 LIVEKIT_KEY=fedeo-livekit
 LIVEKIT_SECRET=change-this-livekit-secret
+
+# Lokale Matrix-Entwicklung
+MATRIX_DEV_SYNAPSE_PORT=8008
+MATRIX_DEV_ELEMENT_PORT=8080
+MATRIX_DEV_RTC_JWT_PORT=8081
+MATRIX_DEV_LIVEKIT_PORT=7880
+MATRIX_DEV_LIVEKIT_TCP_PORT=7881
+MATRIX_DEV_LIVEKIT_RTC_MIN_PORT=50000
+MATRIX_DEV_LIVEKIT_RTC_MAX_PORT=50100
+MATRIX_DEV_TURN_PORT=3478
+MATRIX_DEV_TURN_MIN_PORT=49160
+MATRIX_DEV_TURN_MAX_PORT=49200
diff --git a/.gitignore b/.gitignore
index ab1815e..6afbf84 100644
--- a/.gitignore
+++ b/.gitignore
@@ -3,3 +3,5 @@
 # Lokale Runtime-Daten und generierte Konfigurationen
 matrix/postgres/
 matrix/synapse/
+matrix/dev/postgres/
+matrix/dev/synapse/
diff --git a/docker-compose.yml b/docker-compose.yml
index b57bca1..4531d69 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -247,6 +247,133 @@ services:
       - "traefik.http.routers.fedeo-matrix-rtc-jwt.tls.certresolver=mytlschallenge"
       - "traefik.http.routers.fedeo-matrix-rtc-jwt.middlewares=fedeo-matrix-rtc-jwt-strip"
       - "traefik.http.routers.fedeo-matrix-rtc-jwt.service=fedeo-matrix-rtc-jwt"
+
+  matrix-dev-db:
+    image: postgres:16-alpine
+    restart: unless-stopped
+    profiles:
+      - matrix-dev
+    environment:
+      - POSTGRES_DB=synapse
+      - POSTGRES_USER=synapse
+      - POSTGRES_PASSWORD=synapse-dev-password
+      - POSTGRES_INITDB_ARGS=--encoding=UTF8 --lc-collate=C --lc-ctype=C
+    volumes:
+      - ./matrix/dev/postgres:/var/lib/postgresql/data
+    networks:
+      - traefik
+
+  matrix-dev-redis:
+    image: redis:7-alpine
+    restart: unless-stopped
+    profiles:
+      - matrix-dev
+    networks:
+      - traefik
+
+  matrix-dev-synapse:
+    image: ghcr.io/element-hq/synapse:latest
+    restart: unless-stopped
+    profiles:
+      - matrix-dev
+    depends_on:
+      - matrix-dev-db
+      - matrix-dev-redis
+    environment:
+      - SYNAPSE_CONFIG_PATH=/data/homeserver.yaml
+    volumes:
+      - ./matrix/dev/synapse:/data
+    ports:
+      - "${MATRIX_DEV_SYNAPSE_PORT:-8008}:8008"
+    networks:
+      - traefik
+
+  matrix-dev-turn:
+    image: instrumentisto/coturn:4
+    restart: unless-stopped
+    profiles:
+      - matrix-dev
+    command:
+      - --fingerprint
+      - --use-auth-secret
+      - --static-auth-secret=matrix-dev-turn-secret
+      - --realm=localhost
+      - --listening-port=3478
+      - --min-port=49160
+      - --max-port=49200
+      - --no-cli
+      - --no-tls
+      - --no-dtls
+    ports:
+      - "${MATRIX_DEV_TURN_PORT:-3478}:3478/tcp"
+      - "${MATRIX_DEV_TURN_PORT:-3478}:3478/udp"
+      - "${MATRIX_DEV_TURN_MIN_PORT:-49160}-${MATRIX_DEV_TURN_MAX_PORT:-49200}:49160-49200/udp"
+    networks:
+      - traefik
+
+  matrix-dev-livekit:
+    image: livekit/livekit-server:v1.9
+    restart: unless-stopped
+    profiles:
+      - matrix-dev
+    depends_on:
+      - matrix-dev-redis
+    entrypoint: /bin/sh
+    command:
+      - -ec
+      - |
+        cat >/tmp/livekit.yaml <<EOF
+        port: 7880
+        redis:
+          address: matrix-dev-redis:6379
+        rtc:
+          tcp_port: 7881
+          port_range_start: 50000
+          port_range_end: 50100
+          use_external_ip: false
+        keys:
+          devkey: devsecret
+        room:
+          auto_create: false
+        EOF
+        exec livekit-server --config /tmp/livekit.yaml
+    ports:
+      - "${MATRIX_DEV_LIVEKIT_PORT:-7880}:7880"
+      - "${MATRIX_DEV_LIVEKIT_TCP_PORT:-7881}:7881/tcp"
+      - "${MATRIX_DEV_LIVEKIT_RTC_MIN_PORT:-50000}-${MATRIX_DEV_LIVEKIT_RTC_MAX_PORT:-50100}:50000-50100/udp"
+    networks:
+      - traefik
+
+  matrix-dev-rtc-jwt:
+    image: ghcr.io/element-hq/lk-jwt-service:latest
+    restart: unless-stopped
+    profiles:
+      - matrix-dev
+    depends_on:
+      - matrix-dev-livekit
+      - matrix-dev-synapse
+    environment:
+      - LIVEKIT_URL=ws://localhost:${MATRIX_DEV_LIVEKIT_PORT:-7880}
+      - LIVEKIT_KEY=devkey
+      - LIVEKIT_SECRET=devsecret
+      - LIVEKIT_FULL_ACCESS_HOMESERVERS=localhost
+      - LIVEKIT_JWT_BIND=:8080
+    ports:
+      - "${MATRIX_DEV_RTC_JWT_PORT:-8081}:8080"
+    networks:
+      - traefik
+
+  matrix-dev-element:
+    image: vectorim/element-web:latest
+    restart: unless-stopped
+    profiles:
+      - matrix-dev
+    volumes:
+      - ./matrix/dev/element-config.json:/app/config.json:ro
+    ports:
+      - "${MATRIX_DEV_ELEMENT_PORT:-8080}:80"
+    networks:
+      - traefik
   #  db:
   #    image: postgres
   #    restart: always
diff --git a/matrix/README.md b/matrix/README.md
index 7fe0f8b..d433965 100644
--- a/matrix/README.md
+++ b/matrix/README.md
@@ -94,3 +94,81 @@ docker compose up -d
 - Die aktuellen Ports für TURN und LiveKit müssen auf der Firewall des Servers freigegeben werden.
 - Federation sollte erst nach einer expliziten Entscheidung geöffnet werden. Für B2B-Kommunikation ist eine Allowlist sinnvoll.
 - Die Werte in `.env.example` sind Platzhalter und nicht produktionssicher.
+
+## Lokaler Entwicklungsstack
+
+Für lokale Entwicklung gibt es zusätzlich das Profil `matrix-dev`. Es nutzt direkte Localhost-Ports und braucht keine öffentlichen Domains, kein ACME und keine Traefik-Router.
+
+Lokale Dienste:
+
+- Synapse: `http://localhost:8008`
+- Element Web: `http://localhost:8080`
+- MatrixRTC JWT-Service: `http://localhost:8081`
+- LiveKit: `ws://localhost:7880`
+- TURN: `localhost:3478`
+
+### Lokale Synapse-Konfiguration erzeugen
+
+```bash
+docker compose --profile matrix-dev run --rm \
+  -e SYNAPSE_SERVER_NAME=localhost \
+  -e SYNAPSE_REPORT_STATS=no \
+  matrix-dev-synapse generate
+```
+
+Danach `matrix/dev/synapse/homeserver.yaml` für die lokale Compose anpassen:
+
+```yaml
+public_baseurl: "http://localhost:8008/"
+
+database:
+  name: psycopg2
+  args:
+    user: synapse
+    password: "synapse-dev-password"
+    database: synapse
+    host: matrix-dev-db
+    cp_min: 5
+    cp_max: 10
+
+redis:
+  enabled: true
+  host: matrix-dev-redis
+
+enable_registration: true
+enable_registration_without_verification: true
+
+turn_uris:
+  - "turn:localhost:3478?transport=udp"
+  - "turn:localhost:3478?transport=tcp"
+turn_shared_secret: "matrix-dev-turn-secret"
+turn_user_lifetime: "1h"
+
+experimental_features:
+  msc3266_enabled: true
+  msc4222_enabled: true
+```
+
+### Lokalen Stack starten
+
+```bash
+docker compose --profile matrix-dev up -d \
+  matrix-dev-db \
+  matrix-dev-redis \
+  matrix-dev-synapse \
+  matrix-dev-turn \
+  matrix-dev-livekit \
+  matrix-dev-rtc-jwt \
+  matrix-dev-element
+```
+
+Einen lokalen Admin-Nutzer kannst du danach im Synapse-Container anlegen:
+
+```bash
+docker compose --profile matrix-dev exec matrix-dev-synapse \
+  register_new_matrix_user -c /data/homeserver.yaml http://localhost:8008
+```
+
+Anschließend Element Web unter `http://localhost:8080` öffnen und mit dem lokalen Matrix-Nutzer anmelden.
+
+Wenn FEDEO selbst parallel lokal laufen soll, starte die FEDEO-Dienste separat wie gewohnt. Der lokale Matrix-Stack ist absichtlich über direkte Ports erreichbar, damit er unabhängig von DNS, TLS und Traefik getestet werden kann.
diff --git a/matrix/dev/element-config.json b/matrix/dev/element-config.json
new file mode 100644
index 0000000..f0855bc
--- /dev/null
+++ b/matrix/dev/element-config.json
@@ -0,0 +1,15 @@
+{
+  "default_server_config": {
+    "m.homeserver": {
+      "base_url": "http://localhost:8008",
+      "server_name": "localhost"
+    }
+  },
+  "disable_custom_urls": false,
+  "disable_guests": true,
+  "brand": "FEDEO Matrix Dev",
+  "default_theme": "light",
+  "features": {
+    "feature_video_rooms": true
+  }
+}