tests/test_litellm/proxy/test_custom_proxy.py was an example server script, not a
test: it declared zero test functions but set SERVER_ROOT_PATH at module scope and
then imported proxy_server. proxy_server applies the asset-prefix rewrite at import
time, so merely collecting that file rewrote /litellm-asset-prefix to /my-custom-path
across ~475 tracked files under litellm/proxy/_experimental/out/ and left them dirty,
which invites the UI bundle into unrelated commits. The leaked env var had already
forced a defensive fixture in the MCP server tests.
Move the example to examples/custom_root_path_server.py so pytest can never import it,
and extract the rewrite loop out of module scope into _apply_server_root_path_to_ui_assets
so the behaviour can be exercised against a runtime copy. The helper also skips writing
files whose content is unchanged.
Adds regression coverage: the rewrite is asserted against a temp bundle while the
packaged bundle is hashed before and after, a root-mounted deployment is asserted to be
a no-op, and a guard fails if any module under tests/test_litellm/proxy sets
SERVER_ROOT_PATH at import scope again.
* fix(proxy_server.py): working swagger on custom base
removes the swagger monkey patch - this seems to render the swagger on custom base paths
* fix(ui/): working custom auth uptil login success event
* fix(ui/): working custom server root path for login
* fix(proxy_server.py): create typed dict for ui returned token
allows better documentation of expected params
* refactor(proxy_server.py): refactor all ui login endpoints to use same returned ui token object
* feat(ui_sso.py): add server root path to ui token
* feat(ui_sso.py): allows ui to call correct endpoint
* fix(networking.tsx): update proxy base url with custom root path
* fix(networking.tsx): handle updating proxy base url for non-local instances
* refactor: remove uneccessary references to proxybaseurl in ui code - reduce potential for errors
* fix: fix linting error
* fix(onboarding_link.tsx): fix onboarding link when custom server path is set
* feat(ui_discovery_endpoints.py): add new public .well-known/ route for litellm ui config
returns the server root path and proxy base url for constructing api calls
* feat(_types.py): add litellm well known config as public route
allows ui to query it
* fix(/_types.py): add .well-known config to as public route
* fix(page.tsx): create pattern for loading in ui config before making network requests
ensures requests are formatted correctly
* fix(page.tsx): call credential endpoint once ui config is loaded
* fix(page.tsx): route correctly to litellm dashboard from new user login
* fix(page.tsx): remove hardcoded `/litellm` for /sso/key/generate request
* fix(proxy_server.py): re-add moderations endpoint
* fix(proxy_server.py): mount __next__ at / and /litellm
allows it to work when proxy is mounted on root
* docs(contributing.md): remove /ui on ui doc - it will now run on root
* docs(custom_root_ui.md): add docs on custom root path
