calypso/docs/FRONTEND-RUNNING.md

Frontend Portal Status ✅

🎉 Frontend Dev Server is Running!

Date: 2025-12-24
Status: ✅ RUNNING

---

🌐 Access URLs

Local Access

• URL: http://localhost:3000
• Login Page: http://localhost:3000/login

Network Access (via IP)

• URL: http://10.10.14.16:3000
• Login Page: http://10.10.14.16:3000/login

---

🔐 Login Credentials

Username: admin
Password: admin123

---

✅ Server Status

Frontend (Vite Dev Server)

• ✅ Running on port 3000
• ✅ Listening on all interfaces (0.0.0.0:3000)
• ✅ Accessible via localhost and network IP
• ✅ Process ID: Running in background

Backend (Calypso API)

• ⚠️ Check Status: Verify backend is running on port 8080
• Start if needed:

  cd backend
  export CALYPSO_DB_PASSWORD="calypso123"
  export CALYPSO_JWT_SECRET="test-jwt-secret-key-minimum-32-characters-long"
  go run ./cmd/calypso-api -config config.yaml.example
  

---

🧪 Testing Steps

1. Open Browser: Navigate to http://10.10.14.16:3000/login (or localhost:3000/login)

2. Login:

   • Username: admin
   • Password: admin123

3. Verify Pages:

   • ✅ Dashboard loads
   • ✅ Storage page accessible
   • ✅ Alerts page accessible
   • ✅ Navigation works

---

🔧 Troubleshooting

If Frontend Shows "Connection Refused"

1. Check if dev server is running:

   ps aux | grep vite
   

2. Check if port 3000 is listening:

   netstat -tlnp | grep :3000
   # or
   ss -tlnp | grep :3000
   

3. Restart dev server:

   cd frontend
   npm run dev
   

If Backend API Calls Fail

1. Verify backend is running:

   curl http://localhost:8080/api/v1/health
   

2. Start backend if needed (see above)

3. Check firewall:

   sudo ufw status
   # Allow ports if needed:
   sudo ufw allow 8080/tcp
   sudo ufw allow 3000/tcp
   

---

📊 Current Configuration

Vite Config

• Host: 0.0.0.0 (all interfaces)
• Port: 3000
• Proxy: /api → http://localhost:8080
• Proxy: /ws → ws://localhost:8080

Network

• Server IP: 10.10.14.16
• Frontend: http://10.10.14.16:3000
• Backend: http://10.10.14.16:8080 (if accessible)

---

✅ Summary

Frontend Status: 🟢 RUNNING

• Accessible at: http://10.10.14.16:3000
• Login page: http://10.10.14.16:3000/login
• Ready for testing!

Next Steps:

1. Open browser to http://10.10.14.16:3000/login
2. Login with admin/admin123
3. Test all pages and functionality

🎉 Frontend portal is ready! 🎉