Skip to content

docs: drop shopware/docker Composer package from hosting guides - #2439

Open
Soner (shyim) wants to merge 3 commits into
mainfrom
docs/remove-shopware-docker-composer
Open

docs: drop shopware/docker Composer package from hosting guides#2439
Soner (shyim) wants to merge 3 commits into
mainfrom
docs/remove-shopware-docker-composer

Conversation

@shyim

Copy link
Copy Markdown
Member

Summary

  • Remove the shopware/docker Composer package from the production Docker hosting guide.
  • Create new projects with shopware-cli project create (or npx @shopware-ag/shopware-cli) instead of composer create-project shopware/production.
  • Drop the Flex-recipe recommendation for generating a Dockerfile.
  • Tell Docker users to configure Monolog to stdout/stderr themselves.
  • Inline the TRUSTED_PROXIES Symfony config in the reverse HTTP cache guide instead of linking to the shopware/docker recipe.

Related links

n/a

Checklist

  • I reviewed affected links, code samples, and cross-references, including PageRef references where relevant.
  • I added or updated redirects in .gitbook.yaml if pages were moved, renamed, or deleted.
  • I updated .wordlist.txt (and sorted it) if spellcheck flags new legitimate terms.
  • Any required dependent changes in downstream modules have already been merged and published.
  • This pull request is ready for review.

Notes

Docker images (ghcr.io/shopware/docker-base, docker-dev) are unchanged. This only removes the Composer metapackage / Flex recipe path.

Guide new projects to shopware-cli project create instead of
composer create-project, and inline the TRUSTED_PROXIES example
instead of linking to the Flex recipe.
Copilot AI lite review requested due to automatic review settings August 13, 2026 06:19
@shopware-dev-docs-connector

shopware-dev-docs-connector Bot commented Aug 13, 2026

Copy link
Copy Markdown

Developer Docs healthcheck

Status: Completed with success.
Repository: shopware/docs
Commit: da5ce06
Preview: https://developer-documentation-l3g488der-shopware-frontends.vercel.app
Workflow run: #4781

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Removes guidance that relied on the shopware/docker Composer metapackage/Flex recipe and updates Docker hosting documentation to use Shopware CLI-based project creation and explicit configuration examples instead.

Changes:

  • Update the production Docker hosting guide to create projects via shopware-cli / npx @shopware-ag/shopware-cli and remove the Flex-recipe Dockerfile recommendation.
  • Adjust Docker logging guidance to reflect that stdout/stderr logging needs to be configured by the user (no longer via the Composer package).
  • Inline a TRUSTED_PROXIES Symfony configuration example in the reverse HTTP cache guide (removing the external recipe link).

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
guides/hosting/installation-updates/docker.md Replaces composer create-project / shopware/docker guidance with Shopware CLI project creation and updates related Docker notes.
guides/hosting/infrastructure/reverse-http-cache.md Inlines Symfony TRUSTED_PROXIES configuration example instead of linking to the removed recipe.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

::: info
Since Shopware 6.6, the `TRUSTED_PROXIES` environment variable is no longer taken into account out of the box.
Make sure to create a Symfony configuration to make it configurable again, as shown in the [trusted_env.yaml example](https://github.com/shopware/recipes/blob/main/shopware/docker/0.1/config/packages/trusted_env.yaml).
Create a Symfony configuration to make it configurable again:

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Named the file: create config/packages/trusted_env.yaml.

Show the production monolog.yaml that writes JSON logs to stderr
instead of only mentioning stdout/stderr in passing.
Specify config/packages/trusted_env.yaml so readers know where
to put the TRUSTED_PROXIES Symfony configuration.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants