diff --git a/.env.example b/.env.example
index 3c704b2..91f9c07 100644
--- a/.env.example
+++ b/.env.example
@@ -35,6 +35,10 @@ DB_PASSWORD=CHANGE_ME_SECURE_PASSWORD
 OPENROUTER_API_KEY=your_api_key_here
 OPENROUTER_MODEL=anthropic/claude-sonnet-4
 
+# Übungs-KI (Docker): ohne Eintrag im compose „environment:“ landet keine .env-Zeile im Container.
+# Hier ist SHINKAN_AI_DEBUG in docker-compose*.yml angebunden — 1 = ausführliche WARN-Logs (exercise_ai, openrouter).
+# SHINKAN_AI_DEBUG=1
+
 SMTP_HOST=smtp.example.com
 SMTP_PORT=587
 SMTP_USER=noreply@jinkendo.de
diff --git a/docker-compose.dev-env.yml b/docker-compose.dev-env.yml
index f41e39e..e984c4b 100644
--- a/docker-compose.dev-env.yml
+++ b/docker-compose.dev-env.yml
@@ -29,6 +29,7 @@ services:
       DB_PASSWORD: "${DB_PASSWORD:-dev_password}"
       OPENROUTER_API_KEY: ${OPENROUTER_API_KEY}
       OPENROUTER_MODEL: ${OPENROUTER_MODEL}
+      SHINKAN_AI_DEBUG: "${SHINKAN_AI_DEBUG:-}"
       SMTP_HOST: ${SMTP_HOST}
       SMTP_PORT: ${SMTP_PORT}
       SMTP_USER: ${SMTP_USER}
diff --git a/docker-compose.yml b/docker-compose.yml
index 147266b..fc1b4cf 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -28,6 +28,7 @@ services:
       DB_PASSWORD: ${DB_PASSWORD}
       OPENROUTER_API_KEY: ${OPENROUTER_API_KEY}
       OPENROUTER_MODEL: ${OPENROUTER_MODEL}
+      SHINKAN_AI_DEBUG: "${SHINKAN_AI_DEBUG:-}"
       SMTP_HOST: ${SMTP_HOST}
       SMTP_PORT: ${SMTP_PORT}
       SMTP_USER: ${SMTP_USER}