DocumentationCommerceInstallation Guide

System requirements

Last update: September 18, 2026

CREATED FOR:

  • Experienced
  • Admin
  • Developer

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

Software dependencies for Adobe Commerce on Cloud infrastructure differ from those for on-premises deployments. Adobe determines supported service versions and compatibility based on services tested and deployed in hosted cloud environments. These versions sometimes differ from those supported for on-premises deployments.

IMPORTANT
The system requirements tables list the Adobe Commerce versions they apply to, including releases labeled as beta or early access.
See the release notes for the latest published Commerce versions.
When your service versions do not match the supported configuration for your Commerce version, behavior may differ from what Adobe can reproduce in testing. Adobe Support may ask you to align your environment with a supported configuration before investigating, troubleshooting, or validating the reported behavior. After you align your environment, Adobe Support can continue the investigation.

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

Adobe supports only the system requirement combinations listed in the following tables. Adobe does not validate or support configurations that do not match a listed combination. For example, Adobe Commerce 2.4.9 is tested with MariaDB 12.3. Upgrade to MariaDB 12.3 before you upgrade to 2.4.9.

System requirements for latest Commerce release versions

The following tables summarize the system requirements for the latest release of all supported Commerce versions. Adobe recommends that all customers upgrade to these versions.

Commerce on Cloud

The Commerce on Cloud template provides a default configuration for services compatible with the latest Commerce version for each release line.

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.10
OpenSearch 3
MariaDB 12.3 (recommended), 11.8
New Relic 12.5.0+
PHP 8.5
RabbitMQ 4.3
ActiveMQ Artemis 2
Valkey 9
nginx 1.30
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.10 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.3 4.1
ActiveMQ Artemis 2 2
Valkey 8.1 8
nginx 1.30 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.10 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.3 4.1
ActiveMQ Artemis 2 2
Redis Not supported 7.2
Valkey 8.1 8
nginx 1.30 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.3 4.1
ActiveMQ Artemis 2 2
Redis Not supported 7.2
Valkey 8.1 8
nginx 1.30 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.3 4.1
ActiveMQ Artemis 2 2
Redis Not supported 7.2
Valkey 8.1 8
nginx 1.30 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.13, 3.9 3.9
Redis 7.2 7.2
nginx 1.30 1.28

The services.yaml file defines the default services and versions.
See 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.10
OpenSearch 3
MariaDB 12.3
MySQL 8.4
PHP 8.5
RabbitMQ 4.3
ActiveMQ Artemis 2
Valkey 9
Varnish 8
nginx 1.30
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.10 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.3 4.1
ActiveMQ Artemis 2 2
Valkey 8.1 8
Varnish 8 7.7
nginx 1.30 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.10 2.9.3+
Elasticsearch 8 7.17/8
OpenSearch 2.19, 3 2.19
MariaDB 10.11, 11.8 10.11
MySQL Not supported 8.0
PHP 8.3, 8.2 8.3, 8.2
RabbitMQ 4.3 4.1
ActiveMQ Artemis 2 2
Redis Not supported 7.2
Valkey 8.1 8
Varnish 8 7.7
nginx 1.30 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 Not supported 7.17
OpenSearch 2.19, 3 2.19
MariaDB 10.11 10.11
MySQL Not supported 8.0
PHP 8.2, 8.1 8.2, 8.1
RabbitMQ 4.3 4.1
ActiveMQ Artemis 2 2
Redis Not supported 7.2
Valkey 8.1 8
Varnish 8 7.7
nginx 1.30 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 Not supported 7.17
OpenSearch 2.19 2.19
MariaDB 10.11 10.11, 10.6
MySQL Not supported 8.0
PHP 8.1 8.1
RabbitMQ 4.3 4.1
ActiveMQ Artemis 2 2
Redis Not supported 7.2
Valkey 8.1 8
Varnish 8 7.7
nginx 1.30 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 Not supported 7.17
OpenSearch 2.19 2.19
MariaDB 10.6 10.6
MySQL Not supported 8.0
PHP 8.1 8.1
RabbitMQ 3.13, 3.9 3.9
Redis 7.2 7.2
Varnish 7.7 7.7
nginx 1.30 1.28

MySQL 8.0 reached End of Support (EOS) on April 30, 2026.
After this date, Adobe Commerce 2.4.7, 2.4.6, 2.4.5, and 2.4.4 do not provide compatibility or support for MySQL versions released after MySQL 8.0.
Adobe does not validate or support newer MySQL major versions for these Commerce releases.
If you run Adobe Commerce on-premises versions 2.4.7, 2.4.6, 2.4.5, or 2.4.4, Adobe strongly recommends migrating your database servers to a compatible MariaDB version.

Adobe Commerce on Cloud customers must keep platform dependencies on supported versions. See Platform dependencies in the lifecycle policy.

Elasticsearch 7.17 reached End of Support (EOS) on January 15, 2026.
After this date, Adobe Commerce 2.4.6, 2.4.5, and 2.4.4 do not provide compatibility or support for Elasticsearch versions released after Elasticsearch 7.
Adobe does not validate or support newer Elasticsearch major versions for these Commerce releases.
If you run Adobe Commerce on-premises versions 2.4.6, 2.4.5, or 2.4.4, Adobe strongly recommends migrating your search infrastructure to a compatible OpenSearch version.

System requirements for 2.4.10-alpha Commerce release version

Commerce on Cloud
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 layout-auto
Software dependencies 2.4.10-alpha
Composer 2.10.2+
OpenSearch 3.7+
MariaDB 12.3
PHP 8.5
RabbitMQ 4.3
ActiveMQ Artemis 2.54.0 (latest)
Valkey 9.0
nginx 1.30.2
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 layout-auto
Software dependencies 2.4.10-alpha
ActiveMQ Artemis 2.54.0 (latest)
AWS Aurora (MySQL) 8.0.mysql_aurora.3.12+
AWS ElastiCache ElastiCache version 9.0 for Valkey
AWS MQ 4
AWS OpenSearch Opensearch 3.5
Composer 2.10.2+
MariaDB 12.3
MySQL 8.4
nginx 1.30.2
OpenSearch 3.7+
PHP 8.5
RabbitMQ 4.3
Valkey 9.0
Varnish 9

System requirements for earlier Commerce releases

The following tables list system requirements for Adobe Commerce releases, including those in extended support. Use these tables for reference only. Adobe does not recommend using unsupported versions of software dependencies. Before Adobe Support investigates, troubleshoots, or validates reported behavior, you must align your environment with a supported configuration.

NOTE
Adobe Commerce 2.4.6 is on extended support through August 30, 2027, followed by a security-only transitional period through May 31, 2028. These provisions are available to Adobe Commerce customers only. They do not extend support for third-party dependencies such as MySQL.
If you run Adobe Commerce on Cloud, you must upgrade to a supported release or migrate to Adobe Commerce as a Cloud Service before the June 1, 2028 security requirements and deadlines. See the end of support dates table for full lifecycle dates.
The table is collapsed to minimize the length of this article. Select the header to expand it.
Requirements for earlier releases
tabs
Commerce on Cloud

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

table 0-row-5 1-row-5 2-row-5 3-row-5 4-row-5 5-row-5 6-row-5 7-row-5 8-row-5 9-row-5 layout-auto
Software dependencies 2.4.8-p3 2.4.8-p2 2.4.8-p1 2.4.8
Composer 2.9.3+ 2.9.3+ 2.9.3+ 2.9.3+
OpenSearch 3 3 2 2
MariaDB 11.4 11.4 11.4 11.4
New Relic 11.5.0.18+, 10.15.0.4+ 11.5.0.18+, 10.15.0.4+ 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 8.4, 8.3 8.4, 8.3
RabbitMQ 4.1 4.1 4.1 4.1
ActiveMQ Artemis 2 Not supported Not supported Not supported
Valkey 8 8 8 8
nginx 1.28 1.28 1.26 1.26
table 0-row-10 1-row-10 2-row-10 3-row-10 4-row-10 5-row-10 6-row-10 7-row-10 8-row-10 9-row-10 10-row-10 layout-auto
Software dependencies 2.4.7-p8 2.4.7-p7 2.4.7-p6 2.4.7-p5 2.4.7-p4 2.4.7-p3 2.4.7-p2 2.4.7-p1 2.4.7
Composer 2.9.3+ 2.9.3+ 2.9.3+ 2.9.3+ 2.9.3+ 2.9.3+ 2.9.3+ 2.9.3+ 2.9.3+
OpenSearch 2 2 2 2 2 2 2 2 2
MariaDB 10.11 10.11 10.11 10.6 10.6 10.6 10.6 10.6 10.6
New Relic 10.15.0.4+, 10.7.0.319+ 10.15.0.4+, 10.7.0.319+ 10.15.0.4+, 10.7.0.319+ 10.15.0.4+, 10.7.0.319+ 10.15.0.4+, 10.7.0.319+ 10.15.0.4+, 10.7.0.319+ 10.15.0.4+, 10.7.0.319+ 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 8.3, 8.2 8.3, 8.2 8.3, 8.2 8.3, 8.2 8.3, 8.2 8.3, 8.2 8.3, 8.2
RabbitMQ 4.1 4.1 4.1, 3.13 4.1, 3.13 3.13 3.13 3.13 3.12 3.12
ActiveMQ Artemis 2 Not supported Not supported Not supported Not supported Not supported Not supported Not supported Not supported
Redis 7.2 7.2 7.2 7.2 7.2 7.2 7.2 7.2 7.2
Valkey 8 8 8 Not supported Not supported Not supported Not supported Not supported Not supported
nginx 1.28 1.28 1.26 1.26 1.26 1.26 1.26 1.26 1.26
table 0-row-15 1-row-15 2-row-15 3-row-15 4-row-15 5-row-15 6-row-15 7-row-15 8-row-15 9-row-15 10-row-15 layout-auto
Software dependencies 2.4.6-p13 2.4.6-p12 2.4.6-p11 2.4.6-p10 2.4.6-p9 2.4.6-p8 2.4.6-p7 2.4.6-p6 2.4.6-p5 2.4.6-p4 2.4.6-p3 2.4.6-p2 2.4.6-p1 2.4.6
Composer 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+
OpenSearch 2 2 2 2 2 2 2 2 2 2 2 2 2 2
MariaDB 10.11 10.11 10.11 10.6 10.6 10.6 10.6 10.6 10.6 10.6 10.6 10.6 10.6 10.6
New Relic 10.7.0.319+, 9.19.0.309+ 10.7.0.319+, 9.19.0.309+ 10.7.0.319+, 9.19.0.309+ 10.7.0.319+, 9.19.0.309+ 10.7.0.319+, 9.19.0.309+ 10.7.0.319+, 9.19.0.309+ 10.7.0.319+, 9.19.0.309+ 10.7.0.319+, 9.19.0.309+ 10.7.0.319+, 9.19.0.309+ 10.7.0.319+, 9.19.0.309+ 10.7.0.319+, 9.19.0.309+ 10.7.0.319+, 9.19.0.309+ 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 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1
RabbitMQ 4.1 4.1 4.1, 3.13 4.1, 3.13 3.13 3.13 3.13 3.12 3.12, 3.11, 3.9 3.11, 3.9 3.11, 3.9 3.11, 3.9 3.11, 3.9 3.11, 3.9
ActiveMQ Artemis 2 Not supported Not supported Not supported Not supported Not supported Not supported Not supported Not supported Not supported Not supported Not supported Not supported Not supported
Redis 7.2 7.2 7.2 7.2 7.2 7.2 7.0 7.0 7.0 7.0 7.0 7.0 7.0 7.0
Valkey 8 8 8 Not supported Not supported Not supported Not supported Not supported Not supported Not supported Not supported Not supported Not supported Not supported
nginx 1.28 1.28 1.26 1.26 1.26 1.26 1.26 1.26 1.26 1.26 1.26 1.22 1.22 1.22
table 0-row-17 1-row-17 2-row-17 3-row-17 4-row-17 5-row-17 6-row-17 7-row-17 8-row-17 9-row-17 layout-auto
Software dependencies 2.4.5-p15 2.4.5-p14 2.4.5-p13 2.4.5-p12 2.4.5-p11 2.4.5-p10 2.4.5-p9 2.4.5-p8 2.4.5-p7 2.4.5-p6 2.4.5-p5 2.4.5-p4 2.4.5-p3 2.4.5-p2 2.4.5-p1 2.4.5
Composer 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+
OpenSearch 2 2 2 2 1 1 1 1 1 1 1 1 1 1 1 1
MariaDB 10.6 10.6 10.6 10.6 10.6, 10.5 10.5 10.5 10.5, 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4
New Relic 9.19.0.309+ 9.19.0.309+ 9.19.0.309+ 9.19.0.309+ 9.19.0.309+ 9.19.0.309+ 9.19.0.309+ 9.19.0.309+ 9.19.0.309+ 9.19.0.309+ 9.19.0.309+ 9.19.0.309+ 9.19.0.309+ 9.19.0.309+ 9.19.0.309+ 9.19.0.309+
PHP 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1
RabbitMQ 4.1 4.1 4.1, 3.13 4.1, 3.13 3.13 3.13 3.13 3.12, 3.11 3.12, 3.11, 3.9 3.11, 3.9 3.11, 3.9 3.11, 3.9 3.11, 3.9 3.9 3.9 3.9
Redis 7.2 7.2 7.2 7.2 7.2 7.2 7.0 7.0 7.0 6.2 6.2 6.2 6.2 6.2 6.2 6.2
Valkey 8 8 8 Not supported Not supported Not supported Not supported Not supported Not supported Not supported Not supported Not supported Not supported Not supported Not supported Not supported
nginx 1.28 1.28 1.26 1.26 1.26 1.26 1.26 1.26 1.26 1.26 1.26 1.22 1.22 1.22 1.22 1.22
table 0-row-18 1-row-18 2-row-18 3-row-18 4-row-18 5-row-18 6-row-18 7-row-18 8-row-18 layout-auto
Software dependencies 2.4.4-p16 2.4.4-p15 2.4.4-p14 2.4.4-p13 2.4.4-p12 2.4.4-p11 2.4.4-p10 2.4.4-p9 2.4.4-p8 2.4.4-p7 2.4.4-p6 2.4.4-p5 2.4.4-p4 2.4.4-p3 2.4.4-p2 2.4.4-p1 2.4.4
Composer 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+
OpenSearch 2 2 2 2 1 1 1 1 1 1 1 1 1 1 1 1 1
MariaDB 10.6 10.6 10.6 10.6 10.6, 10.5 10.5 10.5 10.5, 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4
New Relic Not supported 9.19.0.309+ 9.19.0.309+ 9.19.0.309+ 9.19.0.309+ 9.19.0.309+ 9.19.0.309+ 9.19.0.309+ 9.19.0.309+ 9.19.0.309+ 9.19.0.309+ 9.19.0.309+ 9.19.0.309+ 9.19.0.309+ 9.19.0.309+ 9.19.0.309+ 9.19.0.309+
PHP 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1
RabbitMQ 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9
Redis 7.2 7.2 7.2 7.2 7.2 7.2 7.0 7.0 7.0 6.2 6.2 6.2 6.2 6.2 6.2 6.2 6.2
nginx 1.28 1.28 1.26 1.26 1.26 1.26 1.26 1.26 1.26 1.26 1.26 1.22 1.22 1.22 1.22 1.22 1.22

The services.yaml file defines the default services and versions.
See Configure services in the Commerce on Cloud Infrastructure guide.
Commerce on-premises
table 0-row-5 1-row-5 2-row-5 3-row-5 4-row-5 5-row-5 6-row-5 7-row-5 8-row-5 9-row-5 10-row-5 11-row-5 12-row-5 13-row-5 14-row-5 15-row-5 16-row-5 17-row-5 layout-auto
Software dependencies 2.4.8-p3 2.4.8-p2 2.4.8-p1 2.4.8
Composer 2.9.3+ 2.9.3+ 2.9.3+ 2.9.3+
Elasticsearch 8 8 8 8.17
OpenSearch 3 3 2.19 2.19
MariaDB 11.4 11.4 11.4 11.4
MySQL 8.4 8.4 8.4 8.4
PHP 8.4, 8.3 8.4, 8.3 8.4, 8.3 8.4, 8.3
RabbitMQ 4.1 4.1 4.1 4.1
ActiveMQ Artemis 2 -- -- --
Valkey 8 8 8 8
Varnish 7.7 7.7 7.7 7.6
Apache -- 2.4 2.4 2.4
nginx 1.28 1.28 1.26 1.26
AWS Aurora (MySQL) 8.0.mysql_aurora.3.09 or latest available 8.0.mysql_aurora.3.09 or latest available 8.0.mysql_aurora.3.08 or latest available 8.0.mysql_aurora.3.08 or latest available
AWS S3 ✔️ ✔️ ✔️ ✔️
AWS MQ 3.13 or latest available 3.13 or latest available 3.13 or latest available 3.13 or latest available
AWS ElastiCache ElastiCache version 7.1 for Redis OSS (enhanced). Valkey 8 is available. ElastiCache version 7.1 for Redis OSS (enhanced) ElastiCache version 7.1 for Redis OSS (enhanced) ElastiCache version 7.1 for Redis OSS (enhanced)
AWS OpenSearch 2.19 or latest available 2.19 or latest available 2.19 or latest available 2.19 or latest available
table 0-row-10 1-row-10 2-row-10 3-row-10 4-row-10 5-row-10 6-row-10 7-row-10 8-row-10 9-row-10 10-row-10 11-row-10 12-row-10 13-row-10 14-row-10 15-row-10 16-row-10 17-row-10 18-row-10 layout-auto
Software dependencies 2.4.7-p8 2.4.7-p7 2.4.7-p6 2.4.7-p5 2.4.7-p4 2.4.7-p3 2.4.7-p2 2.4.7-p1 2.4.7
Composer 2.9.3+ 2.9.3+ 2.9.3+ 2.9.3+ 2.9.3+ 2.9.3+ 2.9.3+ 2.9.3+ 2.9.3+
Elasticsearch 7.17/8 7.17, 8 7.17, 8 7.17,8.17 8.16 8.11 8.11 8.11 8.11
OpenSearch 2.19 2.19 2.19 2.19 2.12 2.12 2.12 2.12 2.12
MariaDB 10.11 10.11 10.11 10.6 10.6 10.6 10.6 10.6 10.6
MySQL 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0
PHP 8.3, 8.2 8.3, 8.2 8.3, 8.2 8.3, 8.2 8.3, 8.2 8.3, 8.2 8.3, 8.2 8.3, 8.2 8.3, 8.2
RabbitMQ 4.1 4.1 4.1, 3.13 4.1, 3.13 3.13 3.13 3.13 3.13 3.13
ActiveMQ Artemis 2 -- -- -- -- -- -- -- --
Redis 7.2 7.2 7.2 7.2 7.2 7.2 7.2 7.2 7.2
Valkey 8 8 8 -- -- -- -- -- --
Varnish 7.7 7.7 7.7 7.6 7.6 7.5 7.5 7.5 7.5
Apache -- -- 2.4 2.4 2.4 2.4 2.4 2.4 2.4
nginx 1.28 1.28 1.26 1.26 1.26 1.26 1.26 1.26 1.26
AWS Aurora (MySQL) 8.0.mysql_aurora.3.09 or latest available 8.0.mysql_aurora.3.09 or latest available 8.0.mysql_aurora.3.08 or latest available 8.0.mysql_aurora.3.08 or latest available 8.0 8.0 8.0 8.0 8.0
AWS S3 ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️
AWS MQ 3.13 or latest available 3.13 or latest available 3.13 or latest available 3.13 or latest available 3.13 3.11.20 3.11.20 3.11.20 3.11.20
AWS ElastiCache ElastiCache version 7.1 for Redis OSS (enhanced). Valkey 8 is available. ElastiCache version 7.1 for Redis OSS (enhanced). Valkey 8 is available. ElastiCache version 7.1 for Redis OSS (enhanced) ElastiCache version 7.1 for Redis OSS (enhanced) Redis 7.0 Redis 7.0 Redis 7.0 Redis 7.0 Redis 7.0
AWS OpenSearch 2.19 or latest available 2.19 or latest available 2.17 or latest available 2.19 or latest available 2.11 2.11 2.11 2.11 2.11
table 0-row-15 1-row-15 2-row-15 3-row-15 4-row-15 5-row-15 6-row-15 7-row-15 8-row-15 9-row-15 10-row-15 11-row-15 12-row-15 13-row-15 14-row-15 15-row-15 16-row-15 17-row-15 18-row-15 layout-auto
Software dependencies 2.4.6-p13 2.4.6-p12 2.4.6-p11 2.4.6-p10 2.4.6-p9 2.4.6-p8 2.4.6-p7 2.4.6-p6 2.4.6-p5 2.4.6-p4 2.4.6-p3 2.4.6-p2 2.4.6-p1 2.4.6
Composer 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+
Elasticsearch 7.17 7.17 7.17 7.17, 8.17 7.17 8.11, 7.17 8.11, 7.17 8.11, 7.17 8.11, 7.17 8.11, 7.17 8.5, 7.17 8.5, 7.17 8.5, 7.17 8.4, 7.17
OpenSearch 2.19 2.19 2.19 2.19 2.12 2.12 2.12 2.12 2.12 2.5 2.5 2.5 2.5 2.5
MariaDB 10.11 10.11 10.11 10.6 10.6 10.6 10.6 10.6 10.6 10.6 10.6 10.6 10.6 10.6
MySQL 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0
PHP 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1 8.2, 8.1
RabbitMQ 4.1 4.1 4.1, 3.13 4.1, 3.13 3.13 3.13 3.13 3.12 3.12, 3.11, 3.9 3.11, 3.9 3.11, 3.9 3.11, 3.9 3.11, 3.9 3.11, 3.9
ActiveMQ Artemis 2 -- -- -- -- -- -- -- -- -- -- -- -- --
Redis 7.2 7.2 7.2 7.2 7.2 7.2, 7.0 7.0 7.0 7.0 7.0 7.0 7.0 7.0 7.0
Valkey 8 8 8 -- -- -- -- -- -- -- -- -- -- --
Varnish 7.7 7.7 7.7 7.6 7.6 7.5 7.5 7.5 7.5 7.3 7.3 7.3 7.3 7.1
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.28 1.28 1.26 1.26 1.26 1.26 1.26 1.26 1.26 1.26 1.26 1.22 1.22 1.22
AWS Aurora (MySQL) 8.0.mysql_aurora.3.09 or latest available 8.0.mysql_aurora.3.09 or latest available 8.0.mysql_aurora.3.08 or latest available 8.0.mysql_aurora.3.08 or latest available 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0
AWS S3 ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️
AWS MQ 3.13 or latest available 3.13 or latest available 3.13 or latest available 3.13 or latest available 3.13 3.9.16 3.9.16 3.9.16 3.9.16 3.9.16 3.9.16 3.9.16 3.9.16 3.9.16
AWS ElastiCache ElastiCache version 7.1 for Redis OSS (enhanced). Valkey 8 is available. ElastiCache version 7.1 for Redis OSS (enhanced). Valkey 8 is available. ElastiCache version 7.1 for Redis OSS (enhanced) ElastiCache version 7.1 for Redis OSS (enhanced) Redis 6.2 Redis 6.2 Redis 6.2 Redis 6.2 Redis 6.2 Redis 6.2 Redis 6.2 Redis 6.2 Redis 6.2 Redis 6.2
AWS OpenSearch 2.19 or latest available 2.19 or latest available 2.19 or latest available 2.19 or latest available 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2
table 0-row-17 1-row-17 2-row-17 3-row-17 4-row-17 5-row-17 6-row-17 7-row-17 8-row-17 9-row-17 10-row-17 11-row-17 12-row-17 13-row-17 14-row-17 15-row-17 16-row-17 17-row-17 18-row-17 layout-auto
Software dependencies 2.4.5-p15 2.4.5-p14 2.4.5-p13 2.4.5-p12 2.4.5-p11 2.4.5-p10 2.4.5-p9 2.4.5-p8 2.4.5-p7 2.4.5-p6 2.4.5-p5 2.4.5-p4 2.4.5-p3 2.4.5-p2 2.4.5-p1 2.4.5
Composer 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+
Elasticsearch 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17
OpenSearch 2.19 2.19 2.19 2.19 1.3.20 1.3 1.3 1.3 1.3 1.2 1.2 1.2 1.2 1.2 1.2 1.2
MariaDB 10.6 10.6 10.6 10.6 10.6, 10.5 10.5, 10.4 10.5, 10.4 10.5, 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4
MySQL 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0
PHP 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1
RabbitMQ 4.1 4.1 4.1, 3.13 4.1, 3.13 3.13 3.13 3.13 3.12, 3.11 3.12, 3.11, 3.9 3.11, 3.9 3.11, 3.9 3.11, 3.9 3.11, 3.9 3.9 3.9 3.9
Redis 7.2 7.2 7.2 7.2 7.2 7.2, 7.0 7.0 7.0 7.0 6.2 6.2 6.2 6.2 6.2 6.2 6.2
Valkey 8 8 8 -- -- -- -- -- -- -- -- -- -- -- -- --
Varnish 7.7 7.7 7.7 7.6 7.6 7.5 7.5 7.5 7.5 7.3 7.3 7.3 7.3 7.1 7.0 7.0
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 2.4 2.4
nginx 1.28 1.28 1.26 1.26 1.26 1.26 1.26 1.26 1.26 1.26 1.26 1.22 1.22 1.22 1.22 1.22
AWS Aurora (MySQL) -- 8.0.mysql_aurora.3.09 or latest available 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 --
AWS S3 -- ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ --
AWS MQ -- 3.13 or latest available 3.13 3.13 3.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 --
AWS ElastiCache -- ElastiCache version 7.1 for Redis OSS (enhanced). Valkey 8 is available. Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 --
AWS Elasticsearch -- -- -- -- -- -- -- -- -- -- -- -- -- -- 7.9 --
AWS OpenSearch -- 2.19 or latest available 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2 --
table 0-row-18 1-row-18 2-row-18 3-row-18 4-row-18 5-row-18 6-row-18 7-row-18 8-row-18 9-row-18 10-row-18 11-row-18 12-row-18 13-row-18 14-row-18 15-row-18 16-row-18 17-row-18 layout-auto
Software dependencies 2.4.4-p16 2.4.4-p15 2.4.4-p14 2.4.4-p13 2.4.4-p12 2.4.4-p11 2.4.4-p10 2.4.4-p9 2.4.4-p8 2.4.4-p7 2.4.4-p6 2.4.4-p5 2.4.4-p4 2.4.4-p3 2.4.4-p2 2.4.4-p1 2.4.4
Composer 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+ 2.2.26+
Elasticsearch 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.16 7.16 7.16
OpenSearch 2.19 2.19 2.19 2.19 1.3.20 1.3 1.3 1.3 1.3 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2
MariaDB 10.6 10.6 10.6 10.6 10.6, 10.5 10.5, 10.4 10.5, 10.4 10.5, 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4
MySQL 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0
PHP 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1
RabbitMQ 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9
Redis 7.2 7.2 7.2 7.2 7.2 7.2, 7.0 7.0 7.0 7.0 6.2 6.2 6.2 6.2 6.2 6.2 6.2 6.2
Varnish 7.7 7.7 7.7 7.6 7.6 7.5 7.5 7.5 7.5 7.3 7.3 7.3 7.3 7.1 7.0 7.0 7.0
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 2.4 2.4 2.4
nginx 1.28 1.28 1.26 1.26 1.26 1.26 1.26 1.26 1.26 1.26 1.26 1.22 1.22 1.22 1.22 1.22 1.22
AWS Aurora (MySQL) -- -- 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 5.7 5.7 5.7
AWS S3 -- -- ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️
AWS MQ -- -- 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.8.11 3.8.11 3.8.11
AWS ElastiCache -- -- Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6
AWS Elasticsearch -- -- -- -- -- -- -- -- -- -- -- -- -- -- 7.9 7.9 7.9
AWS OpenSearch -- -- 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2 -- -- --

MySQL 8.0 reached End of Support (EOS) on April 30, 2026.
After this date, Adobe Commerce 2.4.7, 2.4.6, 2.4.5, and 2.4.4 do not provide compatibility or support for MySQL versions released after MySQL 8.0.
Adobe does not validate or support newer MySQL major versions for these Commerce releases.
If you run Adobe Commerce on-premises versions 2.4.7, 2.4.6, 2.4.5, or 2.4.4, Adobe strongly recommends migrating your database servers to a compatible MariaDB version.

Adobe Commerce on Cloud customers must keep platform dependencies on supported versions. See Platform dependencies in the lifecycle policy.

Elasticsearch 7.17 reached End of Support (EOS) on January 15, 2026.
After this date, Adobe Commerce 2.4.6, 2.4.5, and 2.4.4 do not provide compatibility or support for Elasticsearch versions released after Elasticsearch 7.
Adobe does not validate or support newer Elasticsearch major versions for these Commerce releases.
If you run Adobe Commerce on-premises versions 2.4.6, 2.4.5, or 2.4.4, Adobe strongly recommends migrating your search infrastructure to a compatible OpenSearch version.

PHP settings

Configure PHP settings, such as memory_limit, to help 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 verifying that PHP OPcache is enabled to improve performance. Many PHP distributions enable OPcache.

  • 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

See the 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

Adobe Commerce supports the latest and previous major versions of the following browsers for the storefront and Admin, except where noted:

  • Microsoft Edge
  • Firefox (any operating system)
  • Chrome (any operating system)
  • Safari (macOS only)
  • Safari for iOS (storefront only)
  • Chrome for Android (storefront only)

Mail server

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

Memory

Upgrading applications and extensions from Commerce Marketplace and other sources can require up to 2 GB of RAM. If your system has less than 2 GB of RAM, create a swap file. Without a swap file, 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 development environments only, use php_xdebug 2.5.x or later. Xdebug can adversely affect performance.

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

NOTE
A known issue with Xdebug 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
commerce-operations-help-installation