Skip to content

Document ADMIN_PATH and STRAPI_ADMIN_BACKEND_URL environment variables#3143

Merged
pwizla merged 1 commit into
strapi:mainfrom
singhvishalkr:cms/document-admin-path-and-backend-url-env-vars
May 11, 2026
Merged

Document ADMIN_PATH and STRAPI_ADMIN_BACKEND_URL environment variables#3143
pwizla merged 1 commit into
strapi:mainfrom
singhvishalkr:cms/document-admin-path-and-backend-url-env-vars

Conversation

@singhvishalkr
Copy link
Copy Markdown
Contributor

What

Issue #2281 flags two environment variables that show up in every strapi build log under "Including the following ENV variables as part of the JS bundle" but are not documented anywhere in cms/configurations/environment:

  • ADMIN_PATH
  • STRAPI_ADMIN_BACKEND_URL

Both are baked into the admin JS bundle at build time by createBuildContext, and both can be overridden via environment variables before running strapi build. STRAPI_TELEMETRY_DISABLED is the only sibling already in the table; the two missing variables are added next to it so the build-output list maps cleanly to the docs.

Where

docusaurus/docs/cms/configurations/environment.md, immediately after the existing STRAPI_TELEMETRY_DISABLED row in the "Strapi's environment variables" table.

Defaults

  • ADMIN_PATH resolves to the pathname of admin.url (default /admin).
  • STRAPI_ADMIN_BACKEND_URL resolves to the pathname of server.url when the admin panel and the back end share the same origin (typically /), otherwise to the full back-end URL. Source: createBuildContext build-time computation using server.absoluteUrl and admin.absoluteUrl.

Closes #2281

@vercel
Copy link
Copy Markdown

vercel Bot commented May 7, 2026

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

Project Deployment Actions Updated (UTC)
documentation Ready Ready Preview, Comment May 7, 2026 4:51pm

Request Review

Copy link
Copy Markdown
Collaborator

@pwizla pwizla left a comment

Choose a reason for hiding this comment

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

LGTM, thanks, @singhvishalkr

@pwizla pwizla self-assigned this May 11, 2026
@pwizla pwizla added pr: chore source: CMS contribution PRs that are part of the Documentation Contribution Program labels May 11, 2026
@pwizla pwizla added this to the 6.25.0 milestone May 11, 2026
@pwizla pwizla merged commit e1eed4f into strapi:main May 11, 2026
10 of 12 checks passed
pwizla added a commit that referenced this pull request May 11, 2026
#3162)

Co-authored-by: Vishal Kumar Singh <vishal.kr.singh2021@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

contribution PRs that are part of the Documentation Contribution Program pr: chore source: CMS

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Request]: Document ADMIN_PATH & STRAPI_ADMIN_BACKEND_URL environment variables

2 participants