Environment Variables
This page lists all environment variables that can be used to configure Shopware.
| Variable | Default Value | Description |
|---|---|---|
ADMIN_OPENSEARCH_URL | (empty) | OpenSearch URL for administration |
APP_BUILD_DIR | {projectRoot}/var/cache | Path to a temporary directory to create cache folder (since 6.6.8.0) |
APP_CACHE_DIR | {projectRoot}/var/cache | Path to a directory to store caches (since 6.6.8.0) |
APP_ENV | prod | Environment |
APP_LOG_DIR | {projectRoot}/var/log | Path to a directory to store logs (since 6.6.8.0) |
APP_SECRET | (empty) | Can be generated with openssl rand -hex 32 |
APP_URL | (empty) | Where Shopware will be accessible |
APP_URL_CHECK_DISABLED | false | Disable URL validation checks |
BLUE_GREEN_DEPLOYMENT | 0 | This needs super privilege to create trigger |
COMPOSER_HOME | /tmp/composer | Caching for the Plugin Manager |
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. |
DATABASE_SSL_CA | (empty) | Path to SSL CA file |
DATABASE_SSL_CERT | (empty) | Path to SSL Cert file |
DATABASE_SSL_DONT_VERIFY_SERVER_CERT | (empty) | Disables verification of the server certificate (1 disables it) |
DATABASE_SSL_KEY | (empty) | Path to SSL Key file |
DATABASE_URL | (empty) | MySQL credentials as DSN |
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 |
FASTLY_API_KEY | (empty) | API key for Fastly CDN integration. Keep this value secure and do not commit it to version control. |
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 |
MAILER_DSN | null://localhost | Mailer DSN (Admin Configuration overwrites this) |
MESSENGER_TRANSPORT_DSN | (empty) | DSN for default async queue (example: amqp://guest:guest@localhost:5672/%2f/default) |
MESSENGER_TRANSPORT_FAILURE_DSN | (empty) | DSN for failed messages queue (example: amqp://guest:guest@localhost:5672/%2f/failure) |
MESSENGER_TRANSPORT_LOW_PRIORITY_DSN | (empty) | DSN for low priority queue (example: amqp://guest:guest@localhost:5672/%2f/low_prio) |
OPENSEARCH_URL | (empty) | Open Search Hosts |
REDIS_PREFIX | (empty) | Prefix for Redis keys |
REDIS_URL | (empty) | Redis connection URL for caching and sessions (example: redis://host:port) |
SHOPWARE_ADMIN_ES_ENABLED | (empty) | Enable Elasticsearch for administration |
SHOPWARE_ADMIN_ES_INDEX_PREFIX | sw-admin | Index prefix for administration Elasticsearch |
SHOPWARE_ADMIN_ES_REFRESH_INDICES | (empty) | Refresh administration indices |
SHOPWARE_ADMINISTRATION_PATH_NAME | admin | Custom path name for administration interface |
SHOPWARE_DBAL_TIMEZONE_SUPPORT_ENABLED | 0 | Enable timezone support in DBAL |
SHOPWARE_DBAL_TOKEN_MINIMUM_LENGTH | 3 | Minimum token length for DBAL (@deprecated v6.8.0) |
SHOPWARE_DISABLE_UPDATE_CHECK | (empty) | Disable automatic update checks |
SHOPWARE_ES_ENABLED | 0 | Open Search Support Enabled? |
SHOPWARE_ES_EXCLUDE_SOURCE | 0 | Exclude source from Elasticsearch |
SHOPWARE_ES_INDEX_PREFIX | (empty) | Open Search Index Prefix |
SHOPWARE_ES_INDEXING_BATCH_SIZE | 100 | Batch size for Elasticsearch indexing |
SHOPWARE_ES_INDEXING_ENABLED | 0 | Open Search Indexing Enabled? |
SHOPWARE_ES_NGRAM_MAX_GRAM | 5 | Maximum n-gram size for Elasticsearch |
SHOPWARE_ES_NGRAM_MIN_GRAM | 4 | Minimum n-gram size for Elasticsearch |
SHOPWARE_ES_THROW_EXCEPTION | 1 | Whether to throw exceptions on Elasticsearch errors (1 to enable, 0 to disable) |
SHOPWARE_ES_USE_LANGUAGE_ANALYZER | 1 | Controls whether language-specific analyzers (like sw_english_analyzer, sw_german_analyzer) are used for search queries. When set to 1, search queries use the same analyzer as the indexed field, providing broader, more fuzzy search results. When set to 0, search queries use sw_whitespace_analyzer instead, providing less fuzzy search results with fewer matches. |
SHOPWARE_HTTP_CACHE_ENABLED | 1 | Is HTTP Cache enabled? |
SHOPWARE_HTTP_DEFAULT_TTL | 7200 | Default TTL for HTTP Cache |
