diff --git a/woodpecker.env.example b/woodpecker.env.example
new file mode 100644
index 0000000..e622e61
--- /dev/null
+++ b/woodpecker.env.example
@@ -0,0 +1,22 @@
+# Woodpecker CI/CD Environment Configuration
+
+# Step 1: Get Gitea OAuth2 Credentials
+# 1. Go to https://git.bryanmail.net
+# 2. Profile → Settings → Applications → OAuth2 Applications
+# 3. Create New OAuth2 Application
+#    - Name: Woodpecker
+#    - Redirect URI: https://woodpecker.bryanmail.net/authorize
+# 4. Copy Client ID and Secret below
+
+WOODPECKER_GITEA_CLIENT=change-me-gitea-client-id
+WOODPECKER_GITEA_SECRET=change-me-gitea-client-secret
+
+# Step 2: Generate Agent Secret (32 random bytes)
+# Generate with: openssl rand -hex 32
+WOODPECKER_AGENT_SECRET=change-me-random-32-byte-secret
+
+# Step 3: PostgreSQL Connection
+# These credentials are for Woodpecker's database
+# Create DB and user first (see deployment guide)
+DB_USER=woodpecker
+DB_PASS=change-me-secure-password