Skip to content

Correct what the url option does and what the admin URL defaults to - #3474

Merged
pwizla merged 1 commit into
mainfrom
cms/proxy-doc-contradictions
Sep 11, 2026
Merged

Correct what the url option does and what the admin URL defaults to#3474
pwizla merged 1 commit into
mainfrom
cms/proxy-doc-contradictions

Conversation

@pwizla

@pwizla pwizla commented Sep 11, 2026

Copy link
Copy Markdown
Collaborator

This PR corrects 2 claims that the deployment guides in #3461 to #3465 showed to be wrong.

The url row of the server configuration table said the option "also enables proxy support such as Apache or Nginx". It does not: url is the address absolute URLs are built from, while trusting the headers a proxy adds is a separate option, proxy.koa. A reader who set only url got no header trust and no warning.

The Dockerfile comment said that without STRAPI_ADMIN_BACKEND_URL "the admin panel defaults to localhost:1337". It does not either: createAbsoluteUrl in packages/core/admin/admin/src/render.ts falls back to window.location.origin when the value is empty, so the admin panel calls the origin it is served from, which is the wanted behavior behind a proxy. Pinning the value at build time is what you do when the admin is served from a different origin than the API.

Direct preview link 👉 here

@pwizla pwizla self-assigned this Sep 11, 2026
@vercel

vercel Bot commented Sep 11, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
documentation Ready Ready Preview Sep 11, 2026 11:00am UTC

Request Review

@pwizla pwizla left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, nice catch

@pwizla pwizla added this to the 7.2.0 milestone Sep 11, 2026
@pwizla
pwizla merged commit e37690d into main Sep 11, 2026
10 checks passed
@pwizla
pwizla deleted the cms/proxy-doc-contradictions branch September 11, 2026 12:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

internal PRs created by the Strapi core team pr: chore source: CMS

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant