diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..7d6866b
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,22 @@
+# Example Environment Configuration
+# Copy this file to .env and update the values as needed
+
+# Database Configuration (external, managed separately)
+DB_HOST=db-host:3306
+DB_NAME=gitea
+DB_USER=gitea
+DB_PASSWORD=change_me_database_password
+
+# Gitea Configuration
+GITEA_DOMAIN=localhost
+GITEA_ROOT_URL=http://localhost:3000
+GITEA_HTTP_PORT=3000
+GITEA_SSH_PORT=2222
+
+# For production (repos.guschin.info):
+# GITEA_DOMAIN=repos.guschin.info
+# GITEA_ROOT_URL=https://repos.guschin.info
+# GITEA_HTTP_PORT=3000
+# GITEA_SSH_PORT=2222
+# GITEA_SSH_LISTEN_PORT  = 2222
+# GITEA_START_SSH_SERVER = true
\ No newline at end of file
diff --git a/.env.local b/.env.local
new file mode 100644
index 0000000..151203c
--- /dev/null
+++ b/.env.local
@@ -0,0 +1,14 @@
+# Local Development Environment Configuration
+
+# Database Configuration
+DB_HOST=db:3306
+DB_NAME=gitea
+DB_USER=gitea
+DB_PASSWORD=gitea_password_local
+MYSQL_ROOT_PASSWORD=root_password_local
+
+# Gitea Configuration
+GITEA_DOMAIN=localhost
+GITEA_ROOT_URL=http://localhost:3000
+GITEA_HTTP_PORT=3000
+GITEA_SSH_PORT=2222
diff --git a/.env.production b/.env.production
new file mode 100644
index 0000000..3c6883e
--- /dev/null
+++ b/.env.production
@@ -0,0 +1,16 @@
+# Production Environment Configuration
+
+# Database Configuration
+DB_HOST=db:3306
+DB_NAME=gitea
+DB_USER=gitea
+DB_PASSWORD=CHANGE_ME_STRONG_PASSWORD
+MYSQL_ROOT_PASSWORD=CHANGE_ME_ROOT_PASSWORD
+
+# Gitea Configuration
+GITEA_DOMAIN=repos.guschin.info
+GITEA_ROOT_URL=https://repos.guschin.info
+GITEA_HTTP_PORT=3000
+GITEA_SSH_PORT=22
+
+# IMPORTANT: Update passwords before deploying to production!
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..4c49bd7
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1 @@
+.env