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 any Unix operating system. Windows is only supported inside WSL 2 or Docker.
Versions
You can use these commands to check your actual environment:
INFO
On many shared hosting environments, you have multiple PHP versions installed. Make sure that you use the correct PHP binary and often CLI and FPM have different php.ini
files. Ask your hosting provider for the correct PHP binary to use and how to change the php.ini
file.
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, 8.3 and 8.4
memory_limit
: 512M minimummax_execution_time
: 30 seconds minimum- Extensions:
ext-amqp
(only required if you plan to use a message queue, which is the default on PaaS)ext-curl
ext-dom
ext-fileinfo
ext-gd
ext-iconv
ext-intl
ext-mbstring
ext-openssl
ext-pcre
ext-pdo
ext-pdo_mysql
ext-phar
ext-simplexml
ext-xml
ext-zip
ext-zlib
- Composer recommended version: 2.2 or higher
This is how you install PHP and Composer:
SQL
MySQL
- Recommended version: 8.4
- Minimum version: 8.0.22
MariaDB
- Recommended version: 11.4
- Minimum version : 10.11.6 or 11.0.4
For optimal MySQL performance, it is advisable to set max_allowed_packet
to a minimum of 32 MB.
This is how you install MariaDB:
JavaScript
- Node.js 22.0.0 or higher
This is how you install Node.js:
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.
Recommended stack
We recommend the following stack:
- Webserver: Caddy
- PHP: 8.4
- SQL: MariaDB 11.4
- Node: 22
- Search: OpenSearch 2.17.1
- Queue: RabbitMQ
- Cache: Valkey 8.0
Recommended PHP ini:
Setup
Once the requirements are fulfilled, follow up with the Template guide to set up Shopware.