CORS errors after deploying a new CMS instance
:::info
Category: Environment & Configuration Issues
Applies to: New CMS client deployments on EKS or GKE
Quick Detection: If login or API requests fail immediately after a fresh deployment and DevTools shows CORS errors mentioning missing Access-Control-Allow-Origin, the client domain is likely not whitelisted.
:::
Symptoms
- Freshly deployed CMS instance loads but login or API calls fail
- Browser console shows CORS errors such as:
No 'Access-Control-Allow-Origin' header is present on the requested resource
- Network requests fail with:
net::ERR_FAILED
- Issue appears immediately after onboarding a new client domain
- Existing environments and older domains continue to function normally
Likely Causes
- The new client domain is not included in the backend CORS allowlist
- Helm values for the target cloud environment are missing the domain entry
- Backend services reject preflight requests from unrecognized origins
What to Check
- Open Browser DevTools → Console
- Look for CORS errors referencing missing
Access-Control-Allow-Origin
- Look for CORS errors referencing missing
- Confirm the request origin
- Verify the exact CMS domain from which requests are being made
- Verify Helm configuration for the deployment environment:
helm-charts/charts/management/<cloud_env>/values.<env>.yaml
where:
<cloud_env>=eksorgke<env>=dev,staging,uat,prod
- Check whether the new client domain is present in the
ALLOWED_ORIGINSfield
How to Fix
Add the new client domain to the ALLOWED_ORIGINS list for the following services:
APP_NAME: management-appcms-serviceAPP_NAME: management-content-serviceAPP_NAME: management-appcms-service
File location:
helm-charts/charts/management/<cloud_env>/values.<env>.yaml
After updating:
- Commit the configuration change
- Redeploy the management services
- Verify the CMS instance again
Prevention Tips
- Include CORS domain whitelisting in the new-client deployment checklist
- Maintain a centralized registry of approved client domains
- Validate
ALLOWED_ORIGINSbefore announcing environment readiness
Related Issues
- Login fails only on newly deployed client environments
- API requests fail while frontend loads successfully
- Preflight request failures in browser DevTools
ℹ️ Note
This issue is purely configuration-related and not caused by frontend application code.