diff --git a/opencode/.env b/opencode/.env
index 3104537..1d1e2c6 100644
--- a/opencode/.env
+++ b/opencode/.env
@@ -1,17 +1,94 @@
-# Name des Stacks im System
-STACK_NAME=opencode-production
-APP_IMAGE_TAG=latest
+# ==============================================================================
+# INFRASTRUKTUR & NETZWERK
+# ==============================================================================
+# Eindeutiger Name für diesen Docker Compose Stack
+STACK_NAME=opencode-v2-production
 
-# Pfade auf Ihrem Server (Absoluter Pfad zu den Festplatten-Ordnern)
+# Die Domain oder IP, unter der OpenCode im Browser aufgerufen wird
+DOMAIN_NAME=opencode.company.local
+
+# Der Port, den der OIDC-Proxy auf Ihrem Docker-Host freigibt
+HOST_PORT=4180
+
+# Der interne Port des Proxies (muss mit der Compose übereinstimmen, Standard: 4180)
+CONTAINER_PORT=4180
+
+
+# ==============================================================================
+# STORAGE / PFADE AUF DEM DOCKER-HOST (SERVER)
+# ==============================================================================
+# Absoluter Pfad zum Hauptordner, in dem alle Git-Projekte liegen werden
+HOST_WORKSPACES_ROOT_PATH=/mnt/storage/opencode/workspaces
+
+# Absoluter Pfad für die persistenten Daten der PostgreSQL-Datenbank
 HOST_DB_VOLUME_PATH=/mnt/storage/opencode/postgres_data
-HOST_WORKSPACE_PATH=/mnt/storage/my-projects/git-codebase
 
-# Sichere Produktions-Datenbank
+# Absoluter Pfad für die OpenCode-Konfigurationen (hier liegt die config.json für MCPs)
+HOST_CONFIG_PATH=/mnt/storage/opencode/config_data
+
+
+# ==============================================================================
+# VERSIONS-STEUERUNG
+# ==============================================================================
+# Die exakte OpenCode Version von GitHub Container Registry (ghcr.io)
+APP_IMAGE_TAG=2.0.0
+
+
+# ==============================================================================
+# INTEGRATION: GLOBALER GIT & GITEA WORFLOW
+# ==============================================================================
+# Der Name, mit dem der KI-Agent Commits in Ihren Repositories signiert
+GIT_USER_NAME=OpenCode AI Developer
+
+# Die E-Mail-Adresse für die automatischen Git-Commits des Agenten
+GIT_USER_EMAIL=opencode-bot@company.local
+
+# Ihr Gitea Personal Access Token (PAT) für automatische Push- und Pull-Rechte
+GITEA_PAT=gtp_ihr_generiertes_gitea_token_hier_eintragen_xxxxxx
+
+
+# ==============================================================================
+# INTEGRIERTE DATENBANK (POSTGRESQL)
+# ==============================================================================
+# Der Administrator-Nutzername für die Applikations-Datenbank
 DB_USER=opencode_admin
-DB_PASSWORD=EinExtremSicheresPasswortHier99!
+
+# Das geheime Passwort für den Datenbank-Nutzer (Bitte stark abändern!)
+DB_PASSWORD=Sicheres_Und_Langes_Datenbank_Passwort_99!
+
+# Der Name der initialen Datenbank innerhalb von PostgreSQL
 DB_NAME=opencode_prod_db
 
-# Ihre KI-Schnittstellen (Einfach eintragen, was Sie nutzen möchten)
-OPENAI_KEY=sk-proj-xxxx...
-ANTHROPIC_KEY=sk-ant-xxxx...
-OPENCODE_ZEN_KEY=zen-xxxx...
\ No newline at end of file
+
+# ==============================================================================
+# KI ANBINDUNG / LLM PROVIDER API KEYS
+# ==============================================================================
+# Ihr API-Schlüssel für OpenAI Modelle (z. B. GPT-4o) - leer lassen falls ungenutzt
+OPENAI_KEY=sk-proj-dein-openai-api-key-hier-eintragen-xxxxxxxxxxxxxxxx
+
+# Ihr API-Schlüssel für Anthropic Modelle (z. B. Claude 3.5 Sonnet)
+ANTHROPIC_KEY=sk-ant-dein-anthropic-api-key-hier-eintragen-xxxxxxxxxxxxxxxx
+
+
+# ==============================================================================
+# OPENID CONNECT (OIDC) SECURITY SETTINGS
+# ==============================================================================
+# Typ des Identity-Providers (z. B. generic, keycloak, authentik, google, github)
+OIDC_PROVIDER=generic
+
+# Die Client-ID, die Sie in Ihrem OIDC-Provider für OpenCode angelegt haben
+OIDC_CLIENT_ID=opencode-web-client
+
+# Das Client-Secret (Passwort) der App-Registrierung Ihres OIDC-Providers
+OIDC_CLIENT_SECRET=dein_geheimes_oidc_client_secret_vom_authenticator_server
+
+# Die vollständige Issuer-URL Ihres Providers (z. B. Keycloak Realm oder Authentik App)
+OIDC_ISSUER_URL=https://company.local
+
+# Ein 32-Byte langer, base64-kodierter Schlüssel zur Verschlüsselung der Session-Cookies.
+# WICHTIG: Im Linux-Terminal generieren via: openssl rand -base64 32
+OIDC_COOKIE_SECRET=VnFlM2RzNHdBQ014TlZaU2JkRk9SdzA9R2VuZXJpZXJ0TWl0T3BlbnNzbA==
+
+# Auf 'true' setzen, wenn Sie ein SSL-Zertifikat (HTTPS) vor dem Port 4180 nutzen.
+# Bei reinem unverschlüsseltem HTTP-Testbetrieb auf 'false' belassen.
+COOKIE_SECURE_HTTPS=false