docker

Author: dunamismax

README.md

@@ -78,6 +78,10 @@ A production-ready template for modern web applications using **The Modern Go St
 git clone https://github.com/dunamismax/go-web-server.git
 cd go-web-server
 
+# Create your environment file
+cp .env.example .env
+# Edit .env with your database credentials (DATABASE_USER, DATABASE_PASSWORD, etc.)
+
 # Start all services (PostgreSQL + App + Caddy)
 docker compose up --build
 
@@ -95,6 +99,10 @@ git clone https://github.com/dunamismax/go-web-server.git
 cd go-web-server
 go mod tidy
 
+# Create your environment file
+cp .env.example .env
+# Edit .env with your database credentials (DATABASE_USER, DATABASE_PASSWORD, etc.)
+
 # Install development tools and dependencies
 mage setup
 

docker-compose.yml

@@ -5,15 +5,15 @@ services:
     container_name: gowebserver-postgres
     restart: unless-stopped
     environment:
-      POSTGRES_USER: user
-      POSTGRES_PASSWORD: password
-      POSTGRES_DB: gowebserver
+      POSTGRES_USER: ${DATABASE_USER}
+      POSTGRES_PASSWORD: ${DATABASE_PASSWORD}
+      POSTGRES_DB: ${DATABASE_NAME}
       POSTGRES_HOST_AUTH_METHOD: md5
     volumes:
       - postgres_data:/var/lib/postgresql/data
       - ./internal/store/migrations:/docker-entrypoint-initdb.d
     healthcheck:
-      test: ["CMD-SHELL", "pg_isready -U user -d gowebserver"]
+      test: ["CMD-SHELL", "pg_isready -U ${DATABASE_USER} -d ${DATABASE_NAME}"]
       interval: 10s
       timeout: 5s
       retries: 5
@@ -34,7 +34,7 @@ services:
     environment:
       # Database configuration
       DATABASE_DRIVER: postgres
-      DATABASE_URL: postgres://user:password@postgres:5432/gowebserver?sslmode=disable
+      DATABASE_URL: postgres://${DATABASE_USER}:${DATABASE_PASSWORD}@postgres:5432/${DATABASE_NAME}?sslmode=disable
 
       # Server configuration
       HTTP_HOST: 0.0.0.0

docs/architecture.md

@@ -152,9 +152,11 @@ Build → Single binary with embedded assets
 ## Monitoring Architecture
 
 **Request Tracing:**
+
 - Unique ID per request with structured logging
 
 **Metrics Collection:**
+
 - HTTP request metrics (duration, status, method)
 - Database connection and query metrics
 - Business metrics (user operations)

docs/development.md

@@ -9,6 +9,10 @@ Local development setup and workflow for the Modern Go Stack.
 git clone https://github.com/dunamismax/go-web-server.git
 cd go-web-server
 
+# Create your environment file
+cp .env.example .env
+# Edit .env with your database credentials (DATABASE_USER, DATABASE_PASSWORD, etc.)
+
 # Install tools and dependencies
 mage setup
 
@@ -129,13 +133,16 @@ func (h *UserHandler) CreateUser(c echo.Context) error {
 
 ## Configuration
 
-**Development environment variables:**
+**Development environment variables (.env file):**
 
 ```bash
 APP_ENVIRONMENT=development
 APP_DEBUG=true
 SERVER_PORT=8080
-DATABASE_URL=postgres://user:password@localhost:5432/gowebserver?sslmode=disable
+DATABASE_USER=your_username
+DATABASE_PASSWORD=your_password
+DATABASE_NAME=gowebserver
+DATABASE_URL=postgres://your_username:your_password@localhost:5432/gowebserver?sslmode=disable
 FEATURES_ENABLE_METRICS=true
 ```
 
@@ -144,11 +151,11 @@ FEATURES_ENABLE_METRICS=true
 **Database:**
 
 ```bash
-# Connect to PostgreSQL in Docker
-docker exec -it gowebserver-postgres psql -U user -d gowebserver
+# Connect to PostgreSQL in Docker (replace with your credentials)
+docker exec -it gowebserver-postgres psql -U ${DATABASE_USER} -d ${DATABASE_NAME}
 
-# Or using local psql client
-psql postgres://user:password@localhost:5432/gowebserver
+# Or using local psql client with your credentials from .env
+psql postgres://${DATABASE_USER}:${DATABASE_PASSWORD}@localhost:5432/${DATABASE_NAME}
 
 # Common commands
 \dt                          # List tables

docs/docker.md

@@ -17,6 +17,10 @@ The application uses a multi-service Docker architecture:
 git clone https://github.com/dunamismax/go-web-server.git
 cd go-web-server
 
+# Create your environment file
+cp .env.example .env
+# Edit .env with your database credentials (DATABASE_USER, DATABASE_PASSWORD, etc.)
+
 # Start all services
 docker compose up --build
 
@@ -31,7 +35,7 @@ open http://localhost:8080   # Direct application access
 
 - **Image**: `postgres:16-alpine`
 - **Port**: 5432 (exposed in development)
-- **Credentials**: user/password (change in production)
+- **Credentials**: Configured via .env file environment variables
 - **Volume**: `postgres_data` for data persistence
 - **Migrations**: Auto-applied on container startup
 
@@ -102,6 +106,10 @@ docker compose --env-file .env.production up -d
 ### Local Development
 
 ```bash
+# Create your environment file
+cp .env.example .env
+# Edit .env with your database credentials
+
 # Start database only
 docker compose up postgres -d
 
@@ -202,6 +210,7 @@ docker network inspect gowebserver-network
 ### Common Issues
 
 **Application won't start:**
+
 ```bash
 # Check dependencies
 docker compose ps
@@ -212,6 +221,7 @@ docker exec gowebserver-postgres pg_isready -U user
 ```
 
 **Caddy SSL issues:**
+
 ```bash
 # Check domain DNS
 nslookup yourdomain.com
@@ -224,6 +234,7 @@ curl -I http://yourdomain.com
 ```
 
 **Database connection issues:**
+
 ```bash
 # Check PostgreSQL logs
 docker compose logs postgres
@@ -235,6 +246,7 @@ docker exec -it gowebserver-postgres psql -U user -d gowebserver -c "SELECT 1;"
 ### Performance Optimization
 
 **Database tuning in docker-compose.yml:**
+
 ```yaml
 postgres:
   environment:
@@ -244,6 +256,7 @@ postgres:
 ```
 
 **Application scaling:**
+
 ```bash
 docker compose up -d --scale app=3
 ```
@@ -330,4 +343,4 @@ gunzip -c backup_20240101_120000.sql.gz | docker exec -i gowebserver-postgres ps
 docker compose up -d app caddy
 ```
 
-This Docker-first architecture provides a robust, scalable, and secure foundation for deploying the Go Web Server in any environment.
+This Docker-first architecture provides a robust, scalable, and secure foundation for deploying the Go Web Server in any environment.