Troubleshooting
Common deployment issues and fixes.
400 Bad Request
Cause: ALLOWED_HOSTS is not set correctly.
Fix: Set TRAK_ALLOWED_HOSTS and redeploy. See Production checklist.
Styles are missing
Cause: Static files were not collected or served.
Fix: Ensure collectstatic runs during your build/release and that the STATIC_ROOT directory is being served.
JavaScript API clients fail
Cause: Absolute URLs are misconfigured (domain or protocol).
Fix: Ensure USE_HTTPS_IN_ABSOLUTE_URLS=True in production and that your site URL/domain matches your deployment.
Emails or Stripe callbacks point to localhost
Cause: Absolute URL configuration is still set for local dev.
Fix: Update your domain settings and redeploy with the correct environment variables.
See the org-wide troubleshooting page at Troubleshooting.