pos-system/microservices/deployments/local/README.md

Local Development Deployment

Docker Compose configuration for running the GoodGo platform locally.

Quick Start

# Setup environment
cp env.local.example .env
cp env.local.example .env.local

# Update all placeholder secrets/connection strings in both files
# before starting the stack.

# Start platform
docker-compose up -d

# View status
docker-compose ps

Access

• Traefik Dashboard: http://localhost:8080
• Auth Service: http://localhost/api/v1/auth
• Web Admin: http://admin.localhost (currently disabled)
• Web Client: http://localhost (currently disabled)

Documentation

For detailed documentation, see:

• English: docs/en/guides/local-deployment.md
• Vietnamese: docs/vi/guides/local-deployment.md

Files

• docker-compose.yml - Service orchestration
• env.local.example - Sanitized environment variables template
• .env - Docker Compose interpolation file (fill with real values)
• .env.local - Local override file (fill with real values)

Common Commands

docker-compose up -d              # Start all
docker-compose logs -f [service]  # View logs
docker-compose down               # Stop all
docker-compose ps                 # Check status

For troubleshooting and advanced usage, see the full documentation above.