branderson
d4288f45ff
GHCR keeps throttling the streamer's base image pull, so drop the GitHub image workflow for now and have users build with docker compose. The forge workflow keeps its retry for the operator's own deployment.
Deployment Documentation
Complete deployment guides for Dotcom Arcade in development, staging, and production environments.
Quick Links
- Docker Deployment - Container-based deployment with Docker Compose
- Environment Variables - Complete environment configuration reference
- Upgrade Guide - Migration steps between versions and per-release notes
- Health Checks - Health check setup and monitoring
- Security Considerations - Production security hardening and best practices
Deployment Options
Docker Deployment (Recommended)
Best for quick deployment, consistent environments, easy scaling, and isolated service containers.
Quick Start:
# Set Flashpoint path
export FLASHPOINT_HOST_PATH=/data/flashpoint
# Build and start all services
docker-compose up -d --build
# Access application
open http://localhost
See Docker Deployment for complete guide.
Development Workflows
Local Development
# Install and run all services
npm run install:all
npm run dev
Configuration: Hot reload, debug logging, lenient rate limits, local Flashpoint path.
Staging Deployment
# Build for staging
NODE_ENV=staging npm run build
# Deploy with Docker
docker-compose -f docker-compose.staging.yml up -d
Production Deployment
# Build for production
NODE_ENV=production npm run build
# Deploy with Docker
docker-compose -f docker-compose.prod.yml up -d
Configuration: Optimized builds, strict rate limits, valid SSL certificate, full monitoring and alerting, automated backups, log rotation.
Infrastructure Overview
Minimum (< 100 users):
- 2 CPU cores, 4GB RAM, 50GB storage
- Ports: 80, 443 (public); 3100 (internal)
Recommended (100-500 users):
- 4-8 CPU cores, 8-16GB RAM, 500GB SSD storage
Large (500+ users):
- 8+ CPU cores, 16-32GB RAM, 1TB+ SSD storage, load balancer, Redis cache, CDN
Storage Planning:
- Full Flashpoint Archive: ~600GB
- User database: < 100MB
- Application logs: ~1GB/month
Next Steps
After deployment:
- Configure monitoring with Health Checks
- Review Security Considerations
- Set up automated backups
- Enable rate limiting and CORS
- Configure log rotation
- Implement CI/CD pipeline
Related Documentation
- API Reference - Complete API endpoints
- Architecture Overview - System design
- Common Pitfalls - Troubleshooting