Skip to content

docs: document environment variable config limitation #2379

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
Jonas Elfering (keulinho) wants to merge 2 commits into from
Closed

docs: document environment variable config limitation #2379

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
482d949
docs: document environment variable config limitation
keulinho Jul 15, 2026
ccf615b
Potential fix for pull request finding
keulinho Jul 15, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 28 additions & 0 deletions guides/hosting/configurations/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,3 +41,31 @@ If you want to aim at a specific environment, you can create a configuration fil
```

For more information on environment-specific configurations, check out the [Symfony Configuration Environments](https://symfony.com/doc/current/configuration.html#configuration-environments) section.

## Available options

Use the following command to display all Shopware configuration options and their default values for your installed version:

```bash
bin/console config:dump-reference shopware
```

## Runtime environment variables

Symfony environment variable placeholders, such as `%env(int:CART_EXPIRE_DAYS)%`, are resolved at runtime. They cannot be used for Shopware configuration options that enforce a positive minimum value while the service container is compiled. Symfony validates these options against an integer placeholder value of `0`, which fails the minimum-value constraint.

@mitelg Michael Telgmann (mitelg) Jul 15, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

aren't all configs affected, that have any validation? or is it really just the validation case of checking values bigger than zero? 🤔


The following options are affected (depending on your Shopware version and its configuration constraints):

- `shopware.filesystem.batch_write_size`
- `shopware.sitemap.batchsize`
- `shopware.media.presigned_upload.expiration_minutes`
- `shopware.dal.batch_size`
- `shopware.dal.max_rule_prices`
- `shopware.dal.versioning.expire_days`
- `shopware.cart.expire_days`
- `shopware.order.deep_link.expire_days`
- `shopware.sales_channel_context.expire_days`
- `shopware.product.search_keyword.relevant_keyword_count`
- `shopware.mcp.app_tool_timeout`

Configure these options with literal values in `config/packages/shopware.yaml` or an environment-specific configuration file instead of using `%env(...)%` placeholders.
Loading