Skip to main content

Troubleshooting

401 Unauthorized (Admin UI)​

  • Verify IDP audience is control-admin and the token contains required roles
  • Check VITE_ACCESS_CONTROL_BASE_URL and CORS configuration

Health Shows FAIL​

  • /api/health may report failures for DB/Redis/env; see backend README
  • /api/health/ready may fail when external providers are down; set CI_OFFLINE=true in non-prod to skip

Seeds Not Applied​

  • Run the appropriate seed targets (TT baseline, AC admin baseline) from SEEDS.md
  • Re-run seeds safely; they are idempotent

CORS Preflight Blocked​

  • Add origins to CORS_ALLOWED_ORIGINS (CSV of origins or hosts)
  • Build logs list the broken path; fix or change to an external link
  • Keep onBrokenLinks: 'warn' for local dev; consider CI link checks for merges