Skip to content

Commit 568048c

Browse files
committed
docs(self-hosted): troubleshooting guide for errors caused of minified assets by CDNs
Closes getsentry/self-hosted#2962
1 parent 75f3ac3 commit 568048c

File tree

1 file changed

+10
-0
lines changed
  • develop-docs/self-hosted/troubleshooting

1 file changed

+10
-0
lines changed

develop-docs/self-hosted/troubleshooting/sentry.mdx

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -51,3 +51,13 @@ worker1:
5151
```
5252
5353
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).
54+
55+
## Cannot load Javascript or CSS files from web interface
56+
57+
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 are already optimized by the bundlers, but isn't being served with minified extensions (e.g. `.min.js`). Therefore, the CDN that you are using will try to optimize the files for the second time, which will result in corrupted files.
58+
59+
Some known paths that you may see this error:
60+
* _static/dist/sentry/entrypoints/sentry.css
61+
* _static/dist/sentry/entrypoints/app.js
62+
63+
To fix this, you can disable the auto optimization performed by your CDN.

0 commit comments

Comments
 (0)