diff --git a/develop-docs/self-hosted/troubleshooting/sentry.mdx b/develop-docs/self-hosted/troubleshooting/sentry.mdx index 4591d56cad46c..64b1831585ba4 100644 --- a/develop-docs/self-hosted/troubleshooting/sentry.mdx +++ b/develop-docs/self-hosted/troubleshooting/sentry.mdx @@ -51,3 +51,13 @@ worker1: ``` To see a more complete example, please see [a sample solution on our community forum](https://forum.sentry.io/t/how-to-clear-backlog-and-monitor-it/10715/14?u=byk). + +## Cannot Load JavaScript or CSS Files From Web Interface + +If you are running your Sentry instance behind a CDN like Cloudflare, Fastify, or the like, you may see some errors of invalid JavaScript or CSS files being loaded from the web interface. This is caused by some static asset files that are already optimized by the bundlers, but aren't being served with minified extensions (for example, `.min.js`). Therefore, the CDN that you are using will try to optimize the files a second time, which will result in corrupted files. + +Some known paths where you may see this error: +* _static/dist/sentry/entrypoints/sentry.css +* _static/dist/sentry/entrypoints/app.js + +To fix this, you can disable the auto optimization performed by your CDN.