diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..8d7db1c
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,20 @@
+# Base path for the console application (used in Next.js routing)
+NEXT_PUBLIC_BASE_PATH=/rustfs/console
+
+# Server host (e.g. https://your-server.com)
+# Used to derive API base URL when NEXT_PUBLIC_API_BASE_URL is not set
+NEXT_PUBLIC_SERVER_HOST=
+
+# API base URL (optional, defaults to ${NEXT_PUBLIC_SERVER_HOST}/rustfs/admin/v3)
+# NEXT_PUBLIC_API_BASE_URL=
+
+# S3 configuration
+NEXT_PUBLIC_S3_ENDPOINT=
+NEXT_PUBLIC_S3_REGION=us-east-1
+
+# Session duration in seconds (optional)
+# NEXT_PUBLIC_SESSION_DURATION_SECONDS=
+
+# Release info (optional, can be fetched from server)
+# NEXT_PUBLIC_VERSION=
+# NEXT_PUBLIC_RELEASE_DATE=
diff --git a/.gitignore b/.gitignore
index 5ef6a52..7b8da95 100644
--- a/.gitignore
+++ b/.gitignore
@@ -32,6 +32,7 @@ yarn-error.log*
 
 # env files (can opt-in for committing if needed)
 .env*
+!.env.example
 
 # vercel
 .vercel