Repository navigation
docs: document the APP_URL verification before app registration - #2662
Draft
Aydin Hassan (AydinHassan) wants to merge 1 commit into
Draft
Aydin Hassan (AydinHassan) wants to merge 1 commit into
Aydin Hassan (AydinHassan) wants to merge 1 commit into
Conversation
Developer Docs healthcheckStatus: Completed with |
Contributor
📢 Developer Announcement RecommendationRecommendation: ❌ No Announcement Recommended No developer announcement signals were detected.
|
Contributor
There was a problem hiding this comment.
🟢 Approval recommended
The focused documentation changes align with the core implementation, and no blocking issues remain.
No open issues 🎉
What changed in this PR
Updates Shopware’s developer documentation for the APP_URL verification behavior planned for version 6.7.17.0.
Changes:
- Documents staging access and shared-cache requirements for verification.
- Explains verification before app re-registration and adds the
app:url:statusandapp:url:verifycommands. - Clarifies
APP_URL_CHECK_DISABLEDand removes obsolete performance advice.
| File | Description |
|---|---|
| resources/references/core-reference/commands-reference.md | Adds the two URL verification commands. |
| guides/plugins/apps/lifecycle/app-registration-setup.md | Explains verification failures leave the shop ID unchanged. |
| guides/hosting/performance/performance-tweaks.md | Removes obsolete advice to disable external URL checks. |
| guides/hosting/installation-updates/creating-a-staging-instance.md | Documents access requirements for the verification endpoint. |
| guides/hosting/installation-updates/cluster-setup.md | Documents the shared verification-cache requirement. |
| guides/hosting/configurations/shopware/environment-variables.md | Clarifies that the flag only hides the Administration warning. |
Review effort: Balanced
Aydin Hassan (AydinHassan)
force-pushed
the
docs/app-url-verification
branch
from
October 23, 2026 13:58
3d68aee to
04442f0
Compare
Shopware 6.7.17.0 verifies that APP_URL reaches the shop before it registers with an app server. A new page describes how the verification works, when it runs, its results, requirements and commands. The staging, cluster and app registration pages link to it, the commands reference lists app:url:status and app:url:verify, and the APP_URL_CHECK_DISABLED description says it only hides the Administration warning. The performance tweak for the Administration check is removed, because the result is now reused.
Aydin Hassan (AydinHassan)
marked this pull request as draft
October 23, 2026 14:12
Aydin Hassan (AydinHassan)
force-pushed
the
docs/app-url-verification
branch
from
October 23, 2026 14:14
04442f0 to
7115551
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Shopware now verifies that
APP_URLreaches the shop before it registers with an app server.app:url:statusandapp:url:verify.APP_URL_CHECK_DISABLEDonly hides the Administration warning.Related links
Checklist
PageRefreferences where relevant..gitbook.yamlif pages were moved, renamed, or deleted..wordlist.txt(and sorted it) if spellcheck flags new legitimate terms.Dependent PRs
Notes
The change ships with 6.7.17.0, which is not released yet.