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 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 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, 8.3 and 8.4
  • memory_limit : 512M minimum
  • max_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:

Webserver

To run Shopware in a development context, the Symfony CLI will work nicely.

Apache
Caddy
Nginx

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:

Performance Tweaks

Setup

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