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 version
• php -m: Shows CLI PHP modules
• php -i | grep memory_limit: Shows your actual CLI PHP memory limit
• composer -v: Shows your actual composer version
• node -v: Shows your actual Node version
• npm -v: Shows your actual NPM version

PHP

• Compatible version: 8.1, 8.2 and 8.3
• memory_limit: 512M minimum
• max_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
  • Not supported versions: 8.0.20, 8.0.21. 8.4.x onwards

• MariaDB

  • Compatible versions: at least 10.3

  • Recommended version: at least 10.11

  • Problematic versions: 10.3.29, 10.4.19, 10.5.10, 10.5.22, 10.6.15, 10.9.8, 10.10.6, 10.11.5, 11.0.3

The media:delete-unused command requires at least MariaDB 10.9 or MySQL 8.

For optimal MySQL performance, it is advisable to have a minimum of 32 MB.

JavaScript

• Node.js 18.0.0 or higher
• NPM 8.0.0 or higher

Redis

• Compatible versions: 6.2 or higher
• Recommended version: 7.2 or higher
• 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: 18
• Search: OpenSearch 2.8.0
• Queue: RabbitMQ
• Redis: 7.2

Recommended PHP ini:

Performance Tweaks

Setup

Once the requirements are fulfilled, follow up with the Template guide to set up Shopware.