local-dev-serverlisted

# Local Development Server Management **Purpose:** Zero-friction local development server management for Empathy Ledger using PM2 **Trigger:** When user needs to start/stop/restart local dev server, or when "address already in use" errors occur --- ## Quick Commands ```bash # Single project (Empathy Ledger only) pm2 start empathy-ledger # Start server pm2 restart empathy-ledger # Restart server pm2 stop empathy-ledger # Stop server pm2 logs empathy-ledger # View logs # Full ACT ecosystem (all projects) /Users/benknight/act-global-infrastructure/deployment/scripts/deploy-act-ecosystem.sh start /Users/benknight/act-global-infrastructure/deployment/scripts/deploy-act-ecosystem.sh restart /Users/benknight/act-global-infrastructure/deployment/scripts/deploy-act-ecosystem.sh stop /Users/benknight/act-global-infrastructure/deployment/scripts/deploy-act-ecosystem.sh logs ``` --- ## Problem This Solves **Pain Points:** - ❌ "address already in use" errors when port is occupied - ❌ Forgetting to restart server after code changes - ❌ Server crashes and doesn't auto-restart - ❌ Can't find which process is using the port - ❌ Manual `npm run dev` is fragile and doesn't persist **Solution:** - ✅ PM2 manages process lifecycle automatically - ✅ Auto-restart on crashes - ✅ Centralized logging - ✅ Works with ACT ecosystem deployment script - ✅ Simple commands for start/stop/restart --- ## When to Use PM2 vs npm run dev ### Use PM2 When: - Working on multiple