Requirements
This page lists the system requirements and supported software versions for developing Shopware 6. Find installation steps for each setup method on their respective pages:
- Docker setup; recommended for most users
- Devenv setup
- Symfony CLI
Requirements for all setups
Before setting up your Shopware 6 development environment, make sure your system is ready. Check these basics before installation:
- You’re using a Unix-based system (macOS or Linux), or Windows with WSL 2 or Docker for full compatibility
- You have admin/root privileges (if required in your organization)
- Git installed and available in your
PATH - You have at least 8 GB RAM (16 GB recommended) and 10 GB free disk space
- Docker Desktop, PHP, or Nix are not already bound to conflicting ports
- You have a reliable Internet connection for dependency downloads
Hardware recommendations
These recommendations ensure smooth local development regardless of setup:
| Component | Recommended |
|---|---|
| CPU | Quad-core or higher |
| Memory (RAM) | 8 GB minimum, 16 GB recommended (especially for Docker) |
| Disk space | ~10 GB free for Shopware + services |
| Operating system | macOS 13+, Windows 10/11 (Pro with WSL 2), or Linux (64-bit) |
Permissions and networking
- Ensure Docker or Symfony CLI has permission to bind to local ports (typically:80 or:8080).
- Allow your system’s firewall to let containers or local web servers communicate internally.
- On Linux, you may need to add your user to the
dockergroup:
sudo usermod -aG docker $USERRecommended stack and supported versions
The following versions and configurations are officially supported for Shopware 6 development:
| Component | Install | Minimum Version | Recommended | Required / Notes |
|---|---|---|---|---|
| PHP | PHP installation guide Composer installation guide | 8.2+ | 8.4 | Required.memory_limit ≥ 512M, max_execution_time ≥ 30s.Required extensions: ctype, curl, dom, fileinfo, gd, iconv, intl, mbstring, openssl, pcre, pdo_mysql, phar, simplexml, xml, zip, zlib.Optional: amqp (for message queues).Composer 2.2+ recommended. macOS note: If you install PHP with Homebrew, the intl extension may not be included by default. Install it separately:brew install php-intl then verify with `php -m |
| SQL | MariaDB installation guide MySQL installation guide | MariaDB ≥ 10.11.6 or MySQL ≥ 8.0.22 | MariaDB 11.4 / MySQL 8.4 | Required.max_allowed_packet ≥ 32M for optimal performance. |
| Node.js / npm | Node.js downloads | Node 20.0.0+ | Node 24 / npm 10 | Required. |
| Search | OpenSearch installation guide | OpenSearch 1.0+ or ElasticSearch 7.8+ | OpenSearch 2.17.1 | Optional. Used for product search and indexing. Note: The search preview in the administration requires OpenSearch 2.12 or later. Support for OpenSearch 3.1 was added in shopware v6.7.3.1 |
| Cache / KV store | Valkey Redis / Redict / Dragonfly | Redis v7+ | Valkey 8.0 | Optional. Used for caching and session storage. Redis-protocol compatible alternatives supported. maxmemory-policy: volatile-lfu. |
| Web server | Caddy setup guide Apache Nginx | Any | Caddy | Required. For local development, the Symfony CLI server works out of the box. |
| Queue | RabbitMQ downloads AWS SQS | Any transport supported by the symfony messenger component | RabbitMQ | Optional. By default the SQL database will be used as a queue, however in production setups it is highly recommended to use a dedicated queue system for scalability and observability reasons. |
See also: PHP performance tweaks guide
Verifying your local environment
Use the following commands to verify your local environment:
INFO
On many systems or hosting environments, multiple PHP versions may be installed. Make sure to use the correct PHP binary, as CLI and FPM often have different php.ini files. Ask your hosting provider for the correct PHP binary and how to adjust php.ini.
php -v: Show CLI PHP versionphp -m: List CLI PHP modulesphp -i | grep memory_limit: Show your CLI PHP memory limitcomposer -V: Show Composer versionnode -v: Show Node versionnpm -v: Show npm version
Next steps
Once your environment meets these requirements, proceed to your preferred installation method:
