Skip to content

Requirements

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.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
    • Problematic versions: 8.0.20, 8.0.21
  • MariaDB

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.

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:

Performance Tweaks

Setup

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