You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@superset.apache.org by "dosubot[bot] (via GitHub)" <gi...@apache.org> on 2026/05/02 03:09:47 UTC
Re: [D] SUPERSET_APP_ROOT and prefixed URL management [superset]
GitHub user dosubot[bot] edited a comment on the discussion: SUPERSET_APP_ROOT and prefixed URL management
<!-- Greeting -->
Hi @jreynard-code! I'm [Dosu](https://go.dosu.dev/dosubot) and I’m helping the superset team.
<!-- Answer -->
The SUPERSET_APP_ROOT feature for running Superset under a non-root path is present in 6.0.0, but it's marked as BETA and has known issues in this release. Some components, like Swagger UI and certain download/export URLs, may not handle the prefix correctly without manual fixes. Several bugs (e.g., double prefix in URLs, asset path issues) were fixed after October 27, 2025, so for the most stable experience, it's recommended to use a release after that date or the latest master branch [details](https://github.com/apache/superset/issues/35883).
To configure a global prefix (e.g., `/analytics`), set these in your `.env-local`:
```
SUPERSET_APP_ROOT = /analytics
STATIC_ASSETS_PREFIX = /analytics
ENABLE_PROXY_FIX = True
```
For Docker, set `SUPERSET_APP_ROOT` in `docker/.env-local` and restart your services. Your reverse proxy (e.g., nginx) should set `X-Script-Name` and `X-Forwarded-Prefix` headers and proxy to the backend. Example nginx config:
```
location /analytics/ {
proxy_set_header X-Script-Name /analytics;
proxy_pass http://localhost:8088/;
}
```
See the [official docs](https://github.com/apache/superset/blob/master/docs/docs/configuration/configuring-superset.mdx) for more.
If you must use 6.0.0, be aware of these limitations. For Swagger UI, you may need to patch the openapi URI manually [example](https://github.com/apache/superset/issues/35464). For the most reliable support, upgrade to a release after late October 2025, where these issues are resolved [reference](https://github.com/apache/superset/issues/35883). The feature is expected to be more stable in future releases (e.g., 6.1).
<!-- Dosu Comment Footer -->
*To reply, just mention [@dosu](https://go.dosu.dev/dosubot?utm_source=github&utm_medium=bot-comment&utm_campaign=github-comment-footer-20260415&utm_content=reply-with-mention&utm_term=apache%2Fsuperset).*
---
Docs are dead. Just use [Dosu](https://dosu.dev?utm_source=github&utm_medium=bot-comment&utm_campaign=github-comment-footer-20260415&utm_content=static-docs-tagline&utm_term=apache%2Fsuperset).
[](https://app.dosu.dev/response-feedback?utm_source=github&utm_medium=bot-comment&utm_campaign=github-comment-footer-20260415&utm_content=static-docs-feedback&utm_term=apache%2Fsuperset&message_id=c4183293-1f0d-4251-a078-a6f414f14935) [](https://github.dosu.com/apache/superset?utm_source=github&utm_medium=bot-comment&utm_campaign=github-comment-footer-20260415&utm_content=static-docs-ask-repo&utm_term=apache%2Fsuperset) [](https://app.dosu.dev/signup?referrer=openSource&source=github-footer&utm_source=github&utm_medium=bot-comment&utm_campaign=github-comment-footer-20260415&utm_content=static-docs-share-team&utm_term=apache%2Fsuperset)
GitHub link: https://github.com/apache/superset/discussions/36903#discussioncomment-15415585
----
This is an automatically sent email for notifications@superset.apache.org.
To unsubscribe, please send an email to: notifications-unsubscribe@superset.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For additional commands, e-mail: notifications-help@superset.apache.org