Infrastructure Documentation

Current Infrastructure - Traefik v3.0 (August 2025)

The do.dev infrastructure has been migrated from Caddy to Traefik v3.0 with automatic failover capabilities.

🎯 Active System

• Reverse Proxy: Traefik v3.0 with Redis provider
• Health Checks: Automatic server health monitoring
• Failover: Intelligent automatic failover between dev servers
• SSL: Cloudflare DNS challenge for automatic certificates
• Configuration: Redis-based dynamic configuration

📚 Current Documentation

✅ Active (Traefik-based)

• TRAEFIK_AUTOMATIC_FAILOVER.md - Complete automatic failover guide (✅ IMPLEMENTED)
• TRAEFIK_MIGRATION_GUIDE.md - Migration from Caddy to Traefik
• MULTI_UPSTREAM_FAILOVER_ARCHITECTURE.md - Architectural overview

🗄️ Archived (Caddy-based - No longer active)

• CADDY2.md - Previous Caddy configuration system
• CADDY_DOCKER_SETUP.md - Previous Docker Caddy setup
• CADDY_SSL_SETUP.md - Previous SSL configuration

🚀 Current Status (August 2, 2025)

• ✅ Automatic failover operational: https://do.dev working perfectly
• ✅ Health checks active: 30s intervals with 5s timeout
• ✅ Dual server support: 10.3.0.33:3005 (active), 10.1.0.33:3005 (disabled when unreachable)
• ✅ Zero-downtime: Automatic server exclusion/inclusion based on health

🛠️ Key Components

Traefik Configuration

• Host: 10.3.3.3 (Traefik proxy server)
• Dashboard: http://10.3.3.3:8080/dashboard/
• Configuration Storage: Redis at 10.3.3.3:6379
• SSL Provider: Cloudflare DNS challenge

Development Servers

• Primary: 10.3.0.33:3005 (currently active)
• Secondary: 10.1.0.33:3005 (disabled when unreachable)

Management Interface

• Dashboard: http://localhost:3000/dashboard/local/servers
• Sync API: /api/traefik/sync
• Health Monitoring: ./scripts/check-health.sh

📝 For Developers

Quick Commands

# Check current health status
./scripts/check-health.sh

# Manual sync (if needed)
node scripts/simple-sync.js

# Check Traefik logs
ssh root@10.3.3.3 "docker logs traefik --tail 20"

# Test https://do.dev
curl -H "Host: do.dev" https://do.dev

Enable/Disable Servers

1. Go to dashboard: http://localhost:3000/dashboard/local/servers
2. Toggle server active/inactive status
3. System automatically syncs and applies health checks

🔧 Migration Status

From Caddy → Traefik: ✅ COMPLETE (August 2025)

• All Caddy-based documentation moved to archive
• Traefik automatic failover fully operational
• Health checks and monitoring active
• Production-ready for dual dev server environment

For detailed implementation guides, see the specific documentation files listed above.