DocumentationCommerceInstallation Guide

[PaaS only]{class="badge informative" title="Applies to Adobe Commerce on Cloud projects (Adobe-managed PaaS infrastructure) and on-premises projects only."}

System requirements

Last update: Tue May 12 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Experienced
  • Admin
  • Developer

The following summarizes software dependencies and services tested for Adobe Commerce.

There are some differences in the dependencies for Commerce on Cloud. Service version and compatibility support for Adobe Commerce on Cloud is determined by services tested and deployed to the hosted cloud environments, and sometimes differ from versions supported by Adobe Commerce on-premises deployments.

NOTE
The system requirements tables identify the specific Adobe Commerce versions covered, including any explicitly labeled beta or early access releases. See the release notes to learn more about the latest published versions of Adobe Commerce.
Service version mismatches relative to your Commerce version can introduce behavior that is not reproducible in supported environments. In these cases, Support may request that you align the environment to a supported configuration (for example, upgrade or downgrade the service version) before we can investigate, troubleshoot, or validate the reported behavior. Once the versions are aligned, Support can proceed with the investigation.

The following tables show versions of third-party software dependencies that Adobe has tested with specific Adobe Commerce releases.

Adobe only supports the combination of system requirements described in the following tables. For example, 2.4.9 is fully tested with MariaDB 12.3. Adobe recommends that you upgrade to MariaDB 12.3 before upgrading to 2.4.9.

Commerce on Cloud

The Commerce on Cloud template provides a default configuration for services compatible with a specific Commerce version.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 layout-auto
Software dependencies 2.4.9
Composer 2.9.3+
OpenSearch 3
MariaDB 11.8, 12.31
New Relic 12.5.0+
PHP 8.5
RabbitMQ 4.2
ActiveMQ Artemis 2
Valkey 9
nginx 1.28
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 layout-auto
Software dependencies 2.4.8-p5 (latest) 2.4.8-p4
Composer 2.9.3+ 2.9.3+
OpenSearch 3 3
MariaDB 11.4, 11.8 11.4
New Relic 11.5.0.18+, 10.15.0.4+ 11.5.0.18+, 10.15.0.4+
PHP 8.4, 8.3 8.4, 8.3
RabbitMQ 4.2 4.1
ActiveMQ Artemis 2 2
Valkey 8.1 8
nginx 1.28 1.28
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 layout-auto
Software dependencies 2.4.7-p10 (latest) 2.4.7-p9
Composer 2.9.3+ 2.9.3+
OpenSearch 2, 3 2
MariaDB 10.11, 11.8 10.11
New Relic 10.15.0.4+, 10.7.0.319+ 10.15.0.4+, 10.7.0.319+
PHP 8.3, 8.2 8.3, 8.2
RabbitMQ 4.2 4.1
ActiveMQ Artemis 2 2
Redis -- 7.2
Valkey 8.1 8
nginx 1.28 1.28
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 layout-auto
Software dependencies 2.4.6-p15 (latest) 2.4.6-p14
Composer 2.2.26+ 2.2.26+
OpenSearch 2, 3 2
MariaDB 10.11 10.11
New Relic 10.7.0.319+, 9.19.0.309+ 10.7.0.319+, 9.19.0.309+
PHP 8.2, 8.1 8.2, 8.1
RabbitMQ 4.2 4.1
ActiveMQ Artemis 2 2
Redis -- 7.2
Valkey 8.1 8
nginx 1.28 1.28
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 layout-auto
Software dependencies 2.4.5-p17 (latest) 2.4.5-p16
Composer 2.2.26+ 2.2.26+
OpenSearch 2 2
MariaDB 10.11 10.11, 10.6
New Relic 9.19.0.309+ 9.19.0.309+
PHP 8.1 8.1
RabbitMQ 4.2 4.1
ActiveMQ Artemis 2 2
Redis -- 7.2
Valkey 8.1 8
nginx 1.28 1.28
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 layout-auto
Software dependencies 2.4.4-p18 (latest) 2.4.4-p17
Composer 2.2.26+ 2.2.26+
OpenSearch 2 2
MariaDB 10.6 10.6
PHP 8.1 8.1
RabbitMQ 3.9 3.9
Redis 7.2 7.2
nginx 1.28 1.28

For default configuration, the services and versions are defined in the services.yaml file.
For more details, refer to Configure services in the Commerce on Cloud Infrastructure guide.

Commerce on-premises
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 layout-auto
Software dependencies 2.4.9
Composer 2.9.3+
OpenSearch 3
MariaDB 11.8, 12.31
MySQL 8.4
PHP 8.5
RabbitMQ 4.2
ActiveMQ Artemis 2
Valkey 9
Varnish 8
nginx 1.28
AWS Aurora (MySQL) 8.0.mysql_aurora.3.12 or latest available
AWS S3 ✔️
AWS MQ 3.13 or latest available
AWS ElastiCache ElastiCache 7.1 for Redis OSS (enhanced). Valkey 8 is available.
AWS OpenSearch 3.1 or latest available
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3 14-row-3 15-row-3 16-row-3 layout-auto
Software dependencies 2.4.8-p5 (latest) 2.4.8-p4
Composer 2.9.3+ 2.9.3+
Elasticsearch 8 8
OpenSearch 3 3
MariaDB 11.4, 11.8 11.4
MySQL 8.4 8.4
PHP 8.4, 8.3 8.4, 8.3
RabbitMQ 4.2 4.1
ActiveMQ Artemis 2 2
Valkey 8.1 8
Varnish 8 7.7
nginx 1.28 1.28
AWS Aurora (MySQL) 8.0.mysql_aurora.3.12 or latest available 8.0.mysql_aurora.3.11.1 or latest
AWS S3 ✔️ ✔️
AWS MQ 3.13 or latest available 3.13 or latest available
AWS ElastiCache ElastiCache 7.1 for Redis OSS (enhanced). Valkey 8 is available. ElastiCache 7.1 for Redis OSS (enhanced). Valkey 8 is available.
AWS OpenSearch 3.1 or latest available 3.1 or latest available
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3 14-row-3 15-row-3 16-row-3 17-row-3 layout-auto
Software dependencies 2.4.7-p10 (latest) 2.4.7-p9
Composer 2.9.3+ 2.9.3+
Elasticsearch 8 7.17/8
OpenSearch 2.19, 3 2.19
MariaDB 10.11, 11.8 10.11
MySQL -- 8.0
PHP 8.3, 8.2 8.3, 8.2
RabbitMQ 4.2 4.1
ActiveMQ Artemis 2 2
Redis -- 7.2
Valkey 8.1 8
Varnish 8 7.7
nginx 1.28 1.28
AWS Aurora (MySQL) 8.0.mysql_aurora.3.12 or latest available 8.0.mysql_aurora.3.11.1 or latest
AWS S3 ✔️ ✔️
AWS MQ 3.13 or latest available 3.13 or latest available
AWS ElastiCache ElastiCache 7.1 for Redis OSS (enhanced). Valkey 8 is available. ElastiCache 7.1 for Redis OSS (enhanced). Valkey 8 is available.
AWS OpenSearch 3.1 or latest available 3.1 or latest available
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3 14-row-3 15-row-3 16-row-3 17-row-3 layout-auto
Software dependencies 2.4.6-p15 (latest) 2.4.6-p14
Composer 2.2.26+ 2.2.26+
Elasticsearch -- 7.17
OpenSearch 2.19, 3 2.19
MariaDB 10.11 10.11
MySQL -- 8.0
PHP 8.2, 8.1 8.2, 8.1
RabbitMQ 4.2 4.1
ActiveMQ Artemis 2 2
Redis -- 7.2
Valkey 8.1 8
Varnish 8 7.7
nginx 1.28 1.28
AWS Aurora (MySQL) 8.0.mysql_aurora.3.12 or latest available 8.0.mysql_aurora.3.11.1 or latest
AWS S3 ✔️ ✔️
AWS MQ 3.13 or latest available 3.13 or latest available
AWS ElastiCache ElastiCache 7.1 for Redis OSS (enhanced). Valkey 8 is available. ElastiCache 7.1 for Redis OSS (enhanced). Valkey 8 is available.
AWS OpenSearch 3.1 or latest available 3.1 or latest available
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 layout-auto
Software dependencies 2.4.5-p17 (latest) 2.4.5-p16
Composer 2.2.26+ 2.2.26+
Elasticsearch -- 7.17
OpenSearch 2.19 2.19
MariaDB 10.11 10.11, 10.6
MySQL -- 8.0
PHP 8.1 8.1
RabbitMQ 4.2 4.1
ActiveMQ Artemis 2 2
Redis -- 7.2
Valkey 8.1 8
Varnish 8 7.7
nginx 1.28 1.28
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 layout-auto
Software dependencies 2.4.4-p18 (latest) 2.4.4-p17
Composer 2.2.26+ 2.2.26+
Elasticsearch -- 7.17
OpenSearch 2.19 2.19
MariaDB 10.6 10.6
MySQL -- 8.0
PHP 8.1 8.1
RabbitMQ 3.9 3.9
Redis 7.2 7.2
Varnish 7.7 7.7
nginx 1.28 1.28

MySQL 8.0 reached End of Support (EOS) on April 30, 2026.
Following this date Adobe Commerce 2.4.7, 2.4.6, 2.4.5, and 2.4.4 will not provide compatibility or
support for any MySQL versions released after MySQL 8.0. Adobe will not
validate or provide support for newer MySQL major versions on this Adobe
Commerce release line.
All Adobe Commerce on-premises customers running versions 2.4.7, 2.4.6, 2.4.5, 2.4.4 are strongly
advised to migrate their database servers to a compatible MariaDB version.

Elasticsearch 7.17 reached End of Support (EOS) on January 15, 2026.
Following this date Adobe Commerce 2.4.6, 2.4.5, and 2.4.4 will not provide compatibility or
support for any Elasticsearch versions released after Elasticsearch 7. Adobe will not
validate or provide support for newer Elasticsearch major versions on this Adobe
Commerce release line.
All Adobe Commerce on-premises customers running versions 2.4.6, 2.4.5, 2.4.4 are strongly
advised to migrate their search infrastructure to a compatible OpenSearch version.

AVAILABILITY
1 Compatibility between MariaDB 12.3 and Adobe Commerce 2.4.9 will be confirmed following the official release of MariaDB 12.3, anticipated in the May–June timeframe.

PHP settings

There are particular PHP configuration settings, such as the memory_limit setting, which can help you to avoid common problems when using Adobe Commerce. See Required PHP settings.

For Cloud configuration guidance, see PHP settings in the Commerce on Cloud Infrastructure guide.

PHP OPcache

Adobe recommends that you verify that PHP OPcache is enabled for performance reasons. The OPcache is enabled in many PHP distributions.

  • For Adobe Commerce on Cloud infrastructure deployments, the opcache extension is installed by default.

  • For Adobe Commerce on-premises deployments:

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

PHP Process Control

Before you can run indexers in parallel mode, you must enable Process Control support (pcntl) in PHP. See Installation in the PHP documentation.

PHPUnit

The supported PHPUnit major version depends on the Adobe Commerce release. Adobe tests 2.4.9 with PHPUnit 12, 2.4.8-p5 with PHPUnit 10, and 2.4.7-p10 through 2.4.4-p18 with PHPUnit 9. Install PHPUnit as a command-line tool at the major version that matches Adobe tested configurations for your release.

PHP extensions

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

TIP
For PHP extensions in the Cloud infrastructure, see Enable PHP extensions in the Commerce on Cloud Infrastructure guide.
Commerce on Cloud

The following table shows the supported PHP extensions when deploying Adobe Commerce on the Cloud platform.

table 0-row-3 1-row-3 layout-auto
Default extensions Installed extensions that cannot be uninstalled Extensions that can be installed and uninstalled as needed
bcmath
bz2
calendar
exif
gd
gettext
intl
libxml
mysqli
opcache
pcntl
pdo_mysql
Reflection
soap
sockets
SPL
standard
swoole
sysvmsg
sysvsem
sysvshm
zip
zlib		 ctype
curl
date
dba
dom
fileinfo
filter
ftp
hash
iconv
json
mbstring
mysqlnd
openssl
pcre
pdo
pdo_sqlite
phar
posix
readline
session
sqlite3
tokenizer
xml
xmlreader
xmlwriter		 geoip
gmp
igbinary
imagick
imap
ldap
mailparse
mcrypt
msgpack
mysqli
oauth
pdo_mysql
propro
pspell
raphf
recode
redis
shmop sockets
sodium
ssh2
tidy
xdebug
xmlrpc
xsl
yaml
Commerce on-premises

Adobe Commerce requires:

  • ext-bcmath
  • ext-ctype
  • ext-curl
  • ext-dom
  • ext-fileinfo
  • ext-filter
  • ext-ftp
  • ext-gd
  • ext-hash
  • ext-iconv
  • ext-intl
  • ext-json
  • ext-libxml
  • ext-mbstring
  • ext-openssl
  • ext-pcre
  • ext-pdo_mysql
  • ext-reflection
  • ext-simplexml
  • ext-soap
  • ext-sockets
  • ext-sodium
  • ext-spl
  • ext-tokenizer
  • ext-xmlwriter
  • ext-xsl
  • ext-zip
  • ext-zlib
  • lib-libxml

Magento Open Source requires:

  • ext-bcmath
  • ext-ctype
  • ext-curl
  • ext-dom
  • ext-fileinfo
  • ext-filter
  • ext-ftp
  • ext-gd
  • ext-hash
  • ext-iconv
  • ext-intl
  • ext-json
  • ext-libxml
  • ext-mbstring
  • ext-openssl
  • ext-pcre
  • ext-pdo_mysql
  • ext-reflection
  • ext-simplexml
  • ext-soap
  • ext-sockets
  • ext-sodium
  • ext-tokenizer
  • ext-xmlwriter
  • ext-xsl
  • ext-zip
  • ext-zlib
  • lib-libxml

Refer to official PHP documentation for installation details.

Other software requirements

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

NOTE
The following requirements apply to the latest 2.4.x patch release of Adobe Commerce. When relevant, Commerce on Cloud infrastructure guidance is provided.

Browsers

Storefront and Admin:

  • Microsoft Edge (latest and previous major version)
  • Firefox (latest and previous major version on any operating system)
  • Chrome (latest and previous major version on any operating system)
  • Safari (latest and previous major version on macOS only)
  • Safari for iOS (latest and previous major version for the storefront)
  • Chrome for Android (latest and previous major version for the storefront)

Mail server

Mail Transfer Agent (MTA) or an SMTP server. Commerce on Cloud infrastructure uses the SendGrid email service.

Memory

Upgrading the applications and extensions you obtain from the Commerce Marketplace and other sources can require up to 2 GB of RAM. If you are using a system with less than 2 GB of RAM, create a swap file. Otherwise, your upgrade might fail.

Operating systems (Linux x86-64)

Linux distributions, such as Red Hat Enterprise Linux (RHEL), CentOS, Ubuntu, Debian, and similar.

Microsoft Windows and macOS are not supported.

Adobe Commerce requires the following system tools for some 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.

For Commerce on Cloud infrastructure, see Fastly configuration in the Commerce on Cloud Infrastructure guide.

Xdebug

For Adobe Commerce, use php_xdebug 2.5.x or later (development environments only; can have an adverse effect on performance).

For Adobe Commerce on Cloud, see Configure Xdebug in the Commerce on Cloud Infrastructure guide.

NOTE
There is a known issue with xdebug that can affect Adobe Commerce installations or access to the storefront or Admin after installation. See Known issue that affects xdebug installation in the Commerce Support Knowledge Base.
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995