GitHub user dosubot[bot] added a comment to 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).* --- <sup>How did I do? [Good](https://app.dosu.dev/response-feedback/c4183293-1f0d-4251-a078-a6f414f14935?feedback_type=great_response) | [Irrelevant](https://app.dosu.dev/response-feedback/c4183293-1f0d-4251-a078-a6f414f14935?feedback_type=irrelevant_answer) | [Incorrect](https://app.dosu.dev/response-feedback/c4183293-1f0d-4251-a078-a6f414f14935?feedback_type=incorrect_sources) | [Verbose](https://app.dosu.dev/response-feedback/c4183293-1f0d-4251-a078-a6f414f14935?feedback_type=too_verbose) | [Hallucination](https://app.dosu.dev/response-feedback/c4183293-1f0d-4251-a078-a6f414f14935?feedback_type=hallucination) | [Report 🐛](https://app.dosu.dev/response-feedback/c4183293-1f0d-4251-a078-a6f414f14935?feedback_type=bug_report) | [Other](https://app.dosu.dev/response-feedback/c4183293-1f0d-4251-a078-a6f414f14935?feedback_type=other)</sup> [](https://app.dosu.dev/a28d3c7e-a9d3-459e-9fb6-3a6f9ff4f357/ask?utm_source=github) [](https://cursor.com/link/prompt?text=The%20SUPERSET_APP_ROOT%20feature%20for%20running%20Superset%20under%20a%20non-root%20path%20is%20present%20in%206.0.0%2C%20but%20it%27s%20marked%20as%20BETA%20and%20has%20known%20issues%20in%20this%20release.%20Some%20components%2C%20like%20Swagger%20UI%20and%20certain%20download/export%20URLs%2C%20may%20not%20handle%20the%20prefix%20correctly%20without%20manual%20fixes.%20Several%20bugs%20%28e.g.%2C%20double%20prefix%20in%20URLs%2C%20asset%20path%20issues%29%20were%20fixed%20after%20October%2027%2C%202025%2C%20so%20for%20the%20most%20stable%20experience%2C%20it%27s%20recommended%20to%20use%20a%20release%20after%20that%20date%20or%20the%20latest%20master%20branch%C2%A0%5Bdetails%5D%28https%3A//github.com/apache/superset/issues/35883%29.%0A%0ATo%20con figure%20a%20global%20prefix%20%28e.g.%2C%20%60/analytics%60%29%2C%20set%20these%20in%20your%20%60.env-local%60%3A%0A%60%60%60%0ASUPERSET_APP_ROOT%20%3D%20/analytics%0ASTATIC_ASSETS_PREFIX%20%3D%20/analytics%0AENABLE_PROXY_FIX%20%3D%20True%0A%60%60%60%0AFor%20Docker%2C%20set%20%60SUPERSET_APP_ROOT%60%20in%20%60docker/.env-local%60%20and%20restart%20your%20services.%20Your%20reverse%20proxy%20%28e.g.%2C%20nginx%29%20should%20set%20%60X-Script-Name%60%20and%20%60X-Forwarded-Prefix%60%20headers%20and%20proxy%20to%20the%20backend.%20Example%20nginx%20config%3A%0A%60%60%60%0Alocation%20/analytics/%20%7B%0A%20%20%20%20proxy_set_header%20X-Script-Name%20/analytics%3B%0A%20%20%20%20proxy_pass%20http%3A//localhost%3A8088/%3B%0A%7D%0A%60%60%60%0ASee%20the%20%5Bofficial%20docs%5D%28https%3A//github.com/apache/superset/blob/master/docs/docs/configuration/configuring-superset.mdx%29%20for%20more.%0A%0AIf%20you%20must%20use%206.0.0%2C%20be%20aware%20of%20these%20limitations.%20For%20Swagger%20UI% 2C%20you%20may%20need%20to%20patch%20the%20openapi%20URI%20manually%C2%A0%5Bexample%5D%28https%3A//github.com/apache/superset/issues/35464%29.%20For%20the%20most%20reliable%20support%2C%20upgrade%20to%20a%20release%20after%20late%20October%202025%2C%20where%20these%20issues%20are%20resolved%C2%A0%5Breference%5D%28https%3A//github.com/apache/superset/issues/35883%29.%20The%20feature%20is%20expected%20to%20be%20more%20stable%20in%20future%20releases%20%28e.g.%2C%206.1%29.) [](https://go.dosu.dev/discord-bot) [](https://twitter.com/intent/tweet?text=%40dosu_ai%20helped%20me%20solve%20this%20issue!&url=https%3A//github.com/apache/superset/discussions/36903) GitHub link: https://github.com/apache/superset/discussions/36903#discussioncomment-15415585 ---- This is an automatically sent email for [email protected]. To unsubscribe, please send an email to: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
