diff --git a/dify-agent/.example.env b/dify-agent/.example.env
new file mode 100644
index 0000000000..679a467488
--- /dev/null
+++ b/dify-agent/.example.env
@@ -0,0 +1,37 @@
+# Dify Agent run server settings template.
+# Mirrors dify_agent.server.settings.ServerSettings with the DIFY_AGENT_ prefix.
+# This template intentionally covers the current run-server settings only.
+
+# Redis
+# Redis connection URL for run records and per-run event streams.
+DIFY_AGENT_REDIS_URL=redis://localhost:6379/0
+# Prefix for Redis run-record and event-stream keys.
+DIFY_AGENT_REDIS_PREFIX=dify-agent
+
+# Shutdown and retention
+# Seconds to wait for active local runs during graceful shutdown before cancellation.
+DIFY_AGENT_SHUTDOWN_GRACE_SECONDS=30
+# Seconds to retain Redis run records and per-run event streams (default: 3 days).
+DIFY_AGENT_RUN_RETENTION_SECONDS=259200
+
+# Plugin daemon
+# Base URL for the Dify plugin daemon used by local runs.
+DIFY_AGENT_PLUGIN_DAEMON_URL=http://localhost:5002
+# API key sent to the Dify plugin daemon.
+DIFY_AGENT_PLUGIN_DAEMON_API_KEY=
+
+# Shared plugin-daemon HTTP client timeouts and limits.
+# Plugin-daemon HTTP connect timeout in seconds.
+DIFY_AGENT_PLUGIN_DAEMON_CONNECT_TIMEOUT=10
+# Plugin-daemon HTTP read timeout in seconds.
+DIFY_AGENT_PLUGIN_DAEMON_READ_TIMEOUT=600
+# Plugin-daemon HTTP write timeout in seconds.
+DIFY_AGENT_PLUGIN_DAEMON_WRITE_TIMEOUT=30
+# Plugin-daemon HTTP connection-pool wait timeout in seconds.
+DIFY_AGENT_PLUGIN_DAEMON_POOL_TIMEOUT=10
+# Maximum total plugin-daemon HTTP connections.
+DIFY_AGENT_PLUGIN_DAEMON_MAX_CONNECTIONS=100
+# Maximum idle keep-alive plugin-daemon HTTP connections.
+DIFY_AGENT_PLUGIN_DAEMON_MAX_KEEPALIVE_CONNECTIONS=20
+# Keep-alive expiry in seconds for idle plugin-daemon HTTP connections.
+DIFY_AGENT_PLUGIN_DAEMON_KEEPALIVE_EXPIRY=30