diff --git a/.env.example b/.env.example
index 7c145ad..f5b66d3 100644
--- a/.env.example
+++ b/.env.example
@@ -1,5 +1,30 @@
-DATABASE_URL=postgresql://postgres:password@localhost:5432/database?sslmode=disable
-ENABLE_CRD_REFLECTION=true
+# Database Configuration
+# PostgreSQL connection string for the Minikura database
+DATABASE_URL="postgresql://user:password@localhost:5432/minikura"
 
-KUBERNETES_NAMESPACE=minikura
-KUBERNETES_SKIP_TLS_VERIFY=true
+# Web Application
+# URL where the web frontend is running (used for CORS)
+WEB_URL="http://localhost:3001"
+
+# API URL that the web frontend should connect to
+NEXT_PUBLIC_API_URL="http://localhost:3000"
+
+# Kubernetes Configuration
+# The Kubernetes namespace where resources will be created
+KUBERNETES_NAMESPACE="minikura"
+
+# Skip TLS certificate verification for Kubernetes API
+KUBERNETES_SKIP_TLS_VERIFY="true"
+
+# Node.js TLS rejection control (needed when KUBERNETES_SKIP_TLS_VERIFY is true)
+NODE_TLS_REJECT_UNAUTHORIZED="0"
+
+# Optional: Service account token for Kubernetes authentication
+# By default, uses ~/.kube/config (local development or in-cluster config)
+# Only set this for production deployments outside the cluster
+# KUBERNETES_SERVICE_ACCOUNT_TOKEN="your-token-here"
+
+# Kubernetes Operator Configuration
+# Enable CRD reflection to automatically sync database state to Kubernetes Custom Resources
+# Set to "false" to disable automatic CRD creation from database entries
+ENABLE_CRD_REFLECTION="true"