PHP 7.3 reaches end of support in December 2021 and Adobe Commerce 2.3.x reaches end of support in April 2022. We strongly recommend planning your upgrade now to Adobe Commerce 2.4.x and PHP 7.4.x to help maintain PCI compliance.

System requirements

If you are working on a Cloud for Adobe Commerce project, see Service versions in the Cloud Guide.

This table notes software versions that were officially tested and supported at the time of the Magento version’s release. Newer versions of required software may work but have not been tested.

  2.3.0 2.3.1 2.3.2 2.3.3 2.3.4 2.3.5 2.3.6 2.3.7 2.4.0 2.4.1 2.4.2 2.4.3
Composer 1.x 1.x 1.x 1.x 1.x 1.x 1.x 2.x 1.x 1.x 2.x 2.x
Elasticsearch 2.x, 5.x 5.x, 6.x 5.x, 6.x 5.x, 6.x 5.x, 6.x 7.6 7.7 7.9 7.6 7.7 7.9 7.9
MariaDB 10.1, 10.2 10.1, 10.2 10.1, 10.2 10.1, 10.2 10.1, 10.2 10.1, 10.2 10.2 10.3 10.2, 10.3, 10.4 10.4 10.4 10.4
MySQL 5.6, 5.7 5.6, 5.7 5.6, 5.7 5.6, 5.7 5.6, 5.7 5.6, 5.7 5.7 5.7 5.7, 8.0 8.0 8.0 8.0
PHP 7.1, 7.2 7.1, 7.2 7.1, 7.2 7.1, 7.2, 7.3 7.2, 7.3 7.2, 7.3 7.3 7.4 7.3, 7.4 7.4 7.4 7.4
RabbitMQ 2.x, 3.7 2.x, 3.7 2.x, 3.7 2.x, 3.7 3.7, 3.8 3.8 3.8 3.8 3.8 3.8 3.8 3.8
Redis 5.x 5.0 5.0 5.0 5.0 5.0 5.0 6.0 5.0 5.0 6.0 6.0
Varnish 4.x, 5.x 4.x, 5.x 4.x, 5.x 6.2 4.x, 5.x, 6.2 6.3 6.4 6.5 6.x 6.2 6.4 6.5
Apache 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4
nginx 1.8 1.8 1.8 1.8 1.8 1.8 1.8 1.8 1.8 1.8 1.8 1.8

Miscellaneous

This section describes support and compatibility for all other types of required and optional software.

All of the following requirements apply to the latest patch release of Magento 2.3.

Mail server

Mail Transfer Agent (MTA) or an SMTP server

Operating systems (Linux x86-64)

Linux distributions, such as RedHat Enterprise Linux (RHEL), CentOS, Ubuntu, Debian, and similar. Magento is not supported on Microsoft Windows and macOS.

PHP extensions

The PHP installation instructions include a step for installing these extensions.

If you install Magento after cloning from the GitHub repository, then make sure you have ext-sockets installed on your system.

  • ext-bcmath

  • ext-ctype

  • ext-curl

  • ext-dom

  • ext-gd

  • ext-hash

  • ext-iconv

  • ext-intl

  • ext-mbstring

  • ext-openssl

  • ext-pdo_mysql

  • ext-simplexml

  • ext-soap

  • ext-xsl

  • ext-zip

Refer to official PHP documentation for installation details.

PHP OPcache

We strongly recommend you verify that PHP OPcache is enabled for performance reasons. The OPcache is enabled in many PHP distributions. To verify if it is installed, see our PHP documentation.

If you must install it separately, see the PHP OPcache documentation.

PHP settings

We recommend particular PHP configuration settings, such as memory_limit, that can avoid common problems when using Magento.

For more information, see Required PHP settings.

PHPUnit

PHPUnit (as a command-line tool) 6.2.0

RAM

Upgrading the Magento applications and extensions you obtain from Magento Marketplaces and other sources can require up to 2GB of RAM. If you are using a system with less than 2GB of RAM, we recommend you create a swap file; otherwise, your upgrade might fail.

System dependencies

Magento requires the following system tools for some of its operations:

SSL

  • A valid security certificate is required for HTTPS.
  • Self-signed SSL certificates are not supported.
  • Transport Layer Security (TLS) requirement - PayPal and repo.magento.com both require TLS 1.2 or later:

Supported browsers

Storefront and Admin:

  • Internet Explorer 11 or later, Microsoft Edge, latest–1
  • Firefox latest, latest–1 (any operating system)
  • Chrome latest, latest–1 (any operating system)
  • Safari latest, latest–1 (Mac OS only)
  • Safari Mobile for iPad 2, iPad Mini, iPad with Retina Display (iOS 12 or later), for desktop storefront
  • Safari Mobile for iPhone 6 or later; iOS 12 or later, for mobile storefront
  • Chrome for mobile latest–1 (Android 4 or later) for mobile storefront

Here, latest–1 means one major version earlier than the latest released version.

Xdebug

php_xdebug 2.5.x or later (development environments only; can have an adverse effect on performance)

There is a known issue with xdebug that can affect Magento installations or access to the storefront or Magento Admin after installation. For details, see Known issue with xdebug.