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

System requirements

The following information 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.

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.

System requirements for earlier Commerce releases

The following tables list system requirements for Adobe Commerce releases including those in extended support. These tables are provided for reference purposes only. Adobe does not recommend using unsupported versions of software dependencies, and Support requires that you align your environment to a supported configuration before we can investigate, troubleshoot, or validate reported behavior.

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.

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.

Other software requirements

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

Browsers

Storefront and Admin:

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

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.