Requirements
Before installing Shopware 6, take a quick look at the requirements below to check if your local environment is capable of running it.
Operating System
Shopware 6 is currently only supported on linux and macOS setups. Windows is only supported inside WSL 2.
Versions
You can use these commands to check your actual environment:
php -v
: Shows CLI PHP versionphp -m
: Shows CLI PHP modulesphp -i | grep memory_limit
: Shows your actual CLI PHP memory limitcomposer -v
: Shows your actual composer versionnode -v
: Shows your actual Node versionnpm -v
: Shows your actual NPM version
PHP
- Compatible version: 8.2 and 8.3
memory_limit
: 512M minimummax_execution_time
: 30 seconds minimum- Extensions:
- ext-curl
- ext-dom
- ext-fileinfo
- ext-gd
- ext-iconv
- ext-intl
- ext-json
- ext-libxml
- ext-mbstring
- ext-openssl (there is an issue with OpenSSL 3.0.7)
- ext-pcre
- ext-pdo
- ext-pdo_mysql
- ext-phar
- ext-simplexml
- ext-xml
- ext-zip
- ext-zlib
- Composer recommended version: 2.0 or higher
SQL
MySQL
- Recommended version: 8.0
- Minimum version: 8.0.17
- Problematic versions: 8.0.20, 8.0.21
MariaDB
Compatible version : at least 10.11
Problematic versions: 10.11.5, 11.0.3
For optimal MySQL performance, it is advisable to set max_allowed_packet
to a minimum of 32 MB.
JavaScript
- Node.js 20.0.0 or higher
- NPM 8.0.0 or higher
Redis or key/value stores
Shopware uses the Redis Protocol and, therefore, supports the following key/value stores:
- Recommended configuration
maxmemory-policy
:volatile-lfu
Webserver
To run Shopware in a development context, the Symfony CLI will work nicely.
Below, you will find the default configuration using either Caddy, Nginx or Apache as a webserver.
Recommended stack
We recommend the following stack:
- Webserver: Caddy
- PHP: 8.2
- SQL: MySQL 8 or Percona MySQL 8
- Node: 20
- Search: OpenSearch 2.8.0
- Queue: RabbitMQ
- Redis: 7.2
Recommended PHP ini:
Setup
Once the requirements are fulfilled, follow up with the Template guide to set up Shopware.