Hosting
Setting up an operating environment for Shopware can be hard, but it doesn't have to be if you follow some general guidelines in the subsequent sections.
Recommended stack and supported versions
The following versions and configurations are officially supported for Shopware 6 development:
| Component | Install | Minimum Version | Recommended | Required / Notes |
|---|---|---|---|---|
| PHP | PHP installation guide Composer installation guide | 8.2+ | 8.4 | Required.memory_limit ≥ 512M, max_execution_time ≥ 30s.Required extensions: ctype, curl, dom, fileinfo, gd, iconv, intl, mbstring, openssl, pcre, pdo_mysql, phar, simplexml, xml, zip, zlib.Optional: amqp (for message queues).Composer 2.2+ recommended. macOS note: If you install PHP with Homebrew, the intl extension may not be included by default. Install it separately:brew install php-intl then verify with `php -m |
| SQL | MariaDB installation guide MySQL installation guide | MariaDB ≥ 10.11.6 or MySQL ≥ 8.0.22 (Innovation releases are not supported) | MariaDB 11.4 / MySQL 8.4 | Required.max_allowed_packet ≥ 32M for optimal performance. |
| Node.js / npm | Node.js downloads | Node 20.0.0+ | Node 24 / npm 10 | Required. |
| Search | OpenSearch installation guide | OpenSearch 1.0+ or ElasticSearch 7.8+ | OpenSearch 2.17.1 | Optional. Used for product search and indexing. Note: The search preview in the administration requires OpenSearch 2.12+ or Elasticsearch 8.8+. Support for OpenSearch 3.1 was added in shopware v6.7.3.1 |
| Cache / KV store | Valkey Redis | Redis v7+ | Valkey 8.0 | Optional. Used for caching and session storage.maxmemory-policy: volatile-lfu. |
| Web server | Caddy setup guide Apache Nginx | Any | Caddy | Required. For local development, the Symfony CLI server works out of the box. |
| Queue | RabbitMQ downloads AWS SQS | Any transport supported by the symfony messenger component | RabbitMQ | Optional. By default the SQL database will be used as a queue, however in production setups it is highly recommended to use a dedicated queue system for scalability and observability reasons. |
See also: PHP performance tweaks guide
Verifying your local environment
Use the following commands to verify your local environment:
INFO
On many systems or hosting environments, multiple PHP versions may be installed. Make sure to use the correct PHP binary, as CLI and FPM often have different php.ini files. Ask your hosting provider for the correct PHP binary and how to adjust php.ini.
php -v: Show CLI PHP versionphp -m: List CLI PHP modulesphp -i | grep memory_limit: Show your CLI PHP memory limitcomposer -V: Show Composer versionnode -v: Show Node versionnpm -v: Show npm version
