Deploy Issues

Symptoms

• Console loads but login or API calls fail
• CORS or network errors in browser devtools
• pull access denied for datahub-backend

Checklist

1. NEXT_PUBLIC_API_URL — must match the browser-reachable API origin; rebuild frontend after changing
2. nginx — /api/ → port 4400, / → port 4300; client_max_body_size for uploads
3. Health — curl http://127.0.0.1:4400/api/health on the host
4. Build API image — docker compose build api if pull denied
5. Secrets — rotate default JWT_SECRET and ADMIN_PASSWORD for production

Related

• Production deployment
• System requirements