From 7ff4e51cf200fcd341f0f65ea25b72f0fb93868e Mon Sep 17 00:00:00 2001 From: Micha Date: Fri, 24 Oct 2025 13:37:52 +0200 Subject: [PATCH] add/missing-envs --- .../shopware/environment-variables.md | 80 ++++++++++++------- 1 file changed, 49 insertions(+), 31 deletions(-) diff --git a/guides/hosting/configurations/shopware/environment-variables.md b/guides/hosting/configurations/shopware/environment-variables.md index b8c6c26b1..2cb74e5ad 100644 --- a/guides/hosting/configurations/shopware/environment-variables.md +++ b/guides/hosting/configurations/shopware/environment-variables.md @@ -9,34 +9,52 @@ nav: This page lists all environment variables that can be used to configure Shopware. -| Variable | Default Value | Description | -|----------------------------------------|---------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `APP_ENV` | `prod` | Environment | -| `APP_SECRET` | (empty) | Can be generated with `openssl rand -hex 32` | -| `APP_CACHE_DIR` | `{projectRoot}/var/cache` | Path to a directory to store caches (since 6.6.8.0) | -| `APP_BUILD_DIR` | `{projectRoot}/var/cache` | Path to a temporary directory to create cache folder (since 6.6.8.0) | -| `APP_LOG_DIR` | `{projectRoot}/var/log` | Path to a directory to store logs (since 6.6.8.0) | -| `INSTANCE_ID` | (empty) | Unique Identifier for the Store: Can be generated with `openssl rand -hex 32` | -| `JWT_PRIVATE_KEY` | (empty) | Can be generated with `shopware-cli project generate-jwt --env` | -| `JWT_PUBLIC_KEY` | (empty) | Can be generated with `shopware-cli project generate-jwt --env` | -| `LOCK_DSN` | `flock` | DSN for Symfony locking | -| `APP_URL` | (empty) | Where Shopware will be accessible | -| `BLUE_GREEN_DEPLOYMENT` | `0` | This needs super privilege to create trigger | -| `DATABASE_URL` | (empty) | MySQL credentials as DSN | -| `DATABASE_SSL_CA` | (empty) | Path to SSL CA file | -| `DATABASE_SSL_CERT` | (empty) | Path to SSL Cert file | -| `DATABASE_SSL_KEY` | (empty) | Path to SSL Key file | -| `DATABASE_SSL_DONT_VERIFY_SERVER_CERT` | (empty) | Disables verification of the server certificate (1 disables it) | -| `MAILER_DSN` | `null://localhost` | Mailer DSN (Admin Configuration overwrites this) | -| `ENABLE_SERVICES` | `auto` | Determines if services are enabled, auto detects that based on `APP_ENV`, other possible values are `true` (or `1`) and `false` (or `0`). When set to `0`, Shopware Services won't be installed on the system | -| `OPENSEARCH_URL` | (empty) | Open Search Hosts | -| `SHOPWARE_ES_ENABLED` | `0` | Open Search Support Enabled? | -| `SHOPWARE_ES_INDEXING_ENABLED` | `0` | Open Search Indexing Enabled? | -| `SHOPWARE_ES_INDEX_PREFIX` | (empty) | Open Search Index Prefix | -| `COMPOSER_HOME` | `/tmp/composer` | Caching for the Plugin Manager | -| `SHOPWARE_HTTP_CACHE_ENABLED` | `1` | Is HTTP Cache enabled? | -| `SHOPWARE_HTTP_DEFAULT_TTL` | `7200` | Default TTL for HTTP Cache | -| `MESSENGER_TRANSPORT_DSN` | (empty) | DSN for default async queue (example: `amqp://guest:guest@localhost:5672/%2f/default`) | -| `MESSENGER_TRANSPORT_LOW_PRIORITY_DSN` | (empty) | DSN for low priority queue (example: `amqp://guest:guest@localhost:5672/%2f/low_prio`) | -| `MESSENGER_TRANSPORT_FAILURE_DSN` | (empty) | DSN for failed messages queue (example: `amqp://guest:guest@localhost:5672/%2f/failure`) | -| `COMPOSER_PLUGIN_LOADER` | (empty) | When set to a non-empty value (e.g., `1` or `true`), enables the Composer plugin loader instead of the database plugin loader. All plugins defined in the root `composer.json` will be automatically active, regardless of database settings. | +| Variable | Default Value | Description | +|------------------------------------------|-----------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `APP_ENV` | `prod` | Environment | +| `APP_SECRET` | (empty) | Can be generated with `openssl rand -hex 32` | +| `APP_CACHE_DIR` | `{projectRoot}/var/cache` | Path to a directory to store caches (since 6.6.8.0) | +| `APP_BUILD_DIR` | `{projectRoot}/var/cache` | Path to a temporary directory to create cache folder (since 6.6.8.0) | +| `APP_LOG_DIR` | `{projectRoot}/var/log` | Path to a directory to store logs (since 6.6.8.0) | +| `INSTANCE_ID` | (empty) | Unique Identifier for the Store: Can be generated with `openssl rand -hex 32` | +| `JWT_PRIVATE_KEY` | (empty) | Can be generated with `shopware-cli project generate-jwt --env` | +| `JWT_PUBLIC_KEY` | (empty) | Can be generated with `shopware-cli project generate-jwt --env` | +| `LOCK_DSN` | `flock` | DSN for Symfony locking | +| `APP_URL` | (empty) | Where Shopware will be accessible | +| `BLUE_GREEN_DEPLOYMENT` | `0` | This needs super privilege to create trigger | +| `DATABASE_URL` | (empty) | MySQL credentials as DSN | +| `DATABASE_SSL_CA` | (empty) | Path to SSL CA file | +| `DATABASE_SSL_CERT` | (empty) | Path to SSL Cert file | +| `DATABASE_SSL_KEY` | (empty) | Path to SSL Key file | +| `DATABASE_SSL_DONT_VERIFY_SERVER_CERT` | (empty) | Disables verification of the server certificate (1 disables it) | +| `MAILER_DSN` | `null://localhost` | Mailer DSN (Admin Configuration overwrites this) | +| `ENABLE_SERVICES` | `auto` | Determines if services are enabled, auto detects that based on `APP_ENV`, other possible values are `true` (or `1`) and `false` (or `0`). When set to `0`, Shopware Services won't be installed on the system | +| `OPENSEARCH_URL` | (empty) | Open Search Hosts | +| `SHOPWARE_ES_ENABLED` | `0` | Open Search Support Enabled? | +| `SHOPWARE_ES_INDEXING_ENABLED` | `0` | Open Search Indexing Enabled? | +| `SHOPWARE_ES_INDEX_PREFIX` | (empty) | Open Search Index Prefix | +| `COMPOSER_HOME` | `/tmp/composer` | Caching for the Plugin Manager | +| `SHOPWARE_HTTP_CACHE_ENABLED` | `1` | Is HTTP Cache enabled? | +| `SHOPWARE_HTTP_DEFAULT_TTL` | `7200` | Default TTL for HTTP Cache | +| `MESSENGER_TRANSPORT_DSN` | (empty) | DSN for default async queue (example: `amqp://guest:guest@localhost:5672/%2f/default`) | +| `MESSENGER_TRANSPORT_LOW_PRIORITY_DSN` | (empty) | DSN for low priority queue (example: `amqp://guest:guest@localhost:5672/%2f/low_prio`) | +| `MESSENGER_TRANSPORT_FAILURE_DSN` | (empty) | DSN for failed messages queue (example: `amqp://guest:guest@localhost:5672/%2f/failure`) | +| `COMPOSER_PLUGIN_LOADER` | (empty) | When set to a non-empty value (e.g., `1` or `true`), enables the Composer plugin loader instead of the database plugin loader. All plugins defined in the root `composer.json` will be automatically active, regardless of database settings. | +| `REDIS_URL` | (empty) | Redis connection URL for caching and sessions | +| `REDIS_PREFIX` | (empty) | Prefix for Redis keys | +| `SERVICE_REGISTRY_URL` | `https://registry.services.shopware.io` | URL for Shopware Services registry | +| `SHOPWARE_ADMINISTRATION_PATH_NAME` | `admin` | Custom path name for administration interface | +| `FASTLY_API_KEY` | (empty) | API key for Fastly CDN integration | +| `SHOPWARE_ES_THROW_EXCEPTION` | `1` | Whether to throw exceptions on Elasticsearch errors | +| `SHOPWARE_ADMIN_ES_ENABLED` | (empty) | Enable Elasticsearch for administration | +| `ADMIN_OPENSEARCH_URL` | (empty) | OpenSearch URL for administration | +| `SHOPWARE_ADMIN_ES_INDEX_PREFIX` | `sw-admin` | Index prefix for administration Elasticsearch | +| `SHOPWARE_ADMIN_ES_REFRESH_INDICES` | (empty) | Refresh administration indices | +| `SHOPWARE_ES_INDEXING_BATCH_SIZE` | `100` | Batch size for Elasticsearch indexing | +| `SHOPWARE_ES_EXCLUDE_SOURCE` | `0` | Exclude source from Elasticsearch | +| `SHOPWARE_ES_NGRAM_MIN_GRAM` | `4` | Minimum n-gram size for Elasticsearch | +| `SHOPWARE_ES_NGRAM_MAX_GRAM` | `5` | Maximum n-gram size for Elasticsearch | +| `APP_URL_CHECK_DISABLED` | `false` | Disable URL validation checks | +| `SHOPWARE_DBAL_TIMEZONE_SUPPORT_ENABLED` | `0` | Enable timezone support in DBAL | +| `SHOPWARE_DBAL_TOKEN_MINIMUM_LENGTH` | `3` | Minimum token length for DBAL | +| `SHOPWARE_DISABLE_UPDATE_CHECK` | (empty) | Disable automatic update checks |