Documentation Commerce Operational Guides

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

Adobe Commerce Operational Guides

Last update: Wed Sep 03 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

Experienced
Admin
Developer

Use this following collection of guides to learn about system administration concepts, processes, tools, and best practices to plan, configure, deploy, and maintain Adobe Commerce projects.

Planning and guidance

Release Information

Review all release information for Adobe Commerce patches and services.

Implementation Playbook

Learn about strategies for planning and implementing a successful Adobe Commerce site.

Security and Compliance

Learn how Adobe Commerce merchants are responsible for maintaining a secure environment.

Performance Best Practices

Use these recommendations to optimize the performance of your Adobe Commerce deployment.

System management

Installation

Learn how to install Adobe Commerce for on-premises deployments.

Configuration

Configure features and services for your Adobe Commerce application.

Upgrade

Learn how to upgrade your Adobe Commerce project to keep your storefront secure and operating efficiently.

Tools

Learn about tools you can use with Adobe Commerce.

What’s New

This page contains the changes made in the last 60 days. We exclude all minor updates, such as copy editing, from this list.

September 3, 2025

Description

Type

Source

Clarified that while Valkey is supported, Valkey-specific CLI commands are only available starting from Adobe Commerce 2.4.9.

Technical

commit

August 29, 2025

Description

Type

Source

Added the detailed description of the issue fixed by the ACSD-66302 patch in the QPT 1.1.69 release.

New topic, qpt

commit

August 28, 2025

Description

Type

Source

Added the detailed description of the issue fixed by the ACP2E-3767 patch in the QPT 1.1.69 release.

New topic, qpt

commit

Added the detailed description of the issue fixed by the ACSD-58108 patch in the QPT 1.1.69 release.

New topic, qpt

commit

August 26, 2025

Description

Type

Source

Added the detailed description of the issue fixed by the ACSD-58131 patch in the QPT 1.1.68 release.

New topic, qpt

commit

Added the detailed description of the issue fixed by the ACSD-66311 patch in the QPT 1.1.69 release.

New topic, qpt

commit

Added the detailed description of the issue fixed by the ACP2E-4050 patch in the QPT 1.1.69 release.

New topic, qpt

commit

Changed OpenSearch Cloud from v2.19 to v2 in system requirements for Commerce on Cloud.

Technical

commit

August 25, 2025

Description

Type

Source

Added the detailed description of the issue fixed by the ACSD-66963 patch in the QPT 1.1.68 release.

New topic, qpt

commit

Added the detailed description of the issue fixed by the ACSD-66506 patch in the QPT 1.1.68 release.

New topic, qpt

commit

August 24, 2025

Description

Type

Source

Added the detailed description of the issue fixed by the ACSD-67347 patch in the QPT 1.1.69 release.

New topic, qpt

commit

August 22, 2025

Description

Type

Source

Added the detailed description of the issue fixed by the ACSD-66889 patch in the QPT 1.1.68 release.

New topic, qpt

commit

Updated the UCT CLI reference after the v3.0.23 release.

Technical

commit

August 21, 2025

Description

Type

Source

Added the detailed description of the issue fixed by the ACSD-66139 patch in the QPT 1.1.67 release.

New topic, qpt

commit

Added the detailed description of the issue fixed by the ACSD-66865 patch in the QPT 1.1.68 release.

New topic, qpt

commit

Added the detailed description of the issue fixed by the ACSD-66965 patch in the QPT 1.1.68 release.

New topic, qpt

commit

Added the detailed description of the issue fixed by the ACSD-62415 patch in the QPT 1.1.68 release.

New topic, qpt

commit

Added the detailed description of the issue fixed by the ACP2E-3731 patch in the QPT 1.1.69 release.

New topic, qpt

commit

August 20, 2025

Description

Type

Source

Added the detailed description of the issue fixed by the ACSD-65983 patch in the QPT 1.1.69 release.

New topic, qpt

commit

Added the detailed description of the issue fixed by the ACSD-57477 patch in the QPT 1.1.69 release.

New topic, qpt

commit

Added the detailed description of the issue fixed by the ACSD-66153 patch in the QPT 1.1.69 release.

New topic, qpt

commit

August 19, 2025

Description

Type

Source

Added the detailed description of the issue fixed by the ACSD-62146 patch in the QPT 1.1.68 release.

New topic, qpt

commit

Added the detailed description of the issue fixed by the ACSD-65938 patch in the QPT 1.1.68 release.

New topic, qpt

commit

Added the detailed description of the issue fixed by the ACP2E-3964 patch in the QPT 1.1.69 release.

New topic, qpt

commit

Added the detailed description of the issue fixed by the ACP2E-3977 patch in the QPT 1.1.69 release.

New topic, qpt

commit

Clarified cloud-specific project requirements for the swoole PHP extension to enable the GraphQL Application Server module.

Technical

commit

August 18, 2025

Description

Type

Source

Added the detailed description of the issue fixed by the AC-15223 patch in the QPT 1.1.69 release.

New topic, qpt

commit

Added the detailed description of the issue fixed by the ACSD-66404 patch in the QPT 1.1.69 release.

New topic, qpt

commit

Added the detailed description of the issue fixed by the ACSD-67264 patch in the QPT 1.1.69 release.

New topic, qpt

commit

Added the detailed description of the issue fixed by the ACSD-66952 patch in the QPT 1.1.69 release.

New topic, qpt

commit

Added the detailed description of the issue fixed by the ACSD-56226 patch in the QPT 1.1.69 release.

New topic, qpt

commit

Added the detailed description of the issue fixed by the ACSD-66149 patch in the QPT 1.1.69 release.

New topic, qpt

commit

Fixed AWS system requirements for Adobe Commerce v2.4.5-p14.
Credit: mustdobetter.

Technical

commit

August 15, 2025

Description

Type

Source

Added the detailed description of the issue fixed by the ACSD-67039 patch in the QPT 1.1.68 release.

New topic, qpt

commit

Deleted ActiveMQ dependency from the system requirements.

Technical

commit

August 13, 2025

Description

Type

Source

Added Overview: Quality Patches Tool (QPT) v1.1.69.

New topic, qpt

commit

August 12, 2025

Description

Type

Source

Added the detailed description of the issue fixed by the ACSD-66301 patch in the QPT 1.1.67 release.

New topic, qpt

commit

Update Released versions with August’25 releases.
Fixed system requirement for Varnish in 2.4.8-p1.

Technical

commit

Added system requirements for the 2.4.9-alpha2, 2.4.8-p2, 2.4.7-p7, 2.4.6-p12, 2.4.5-p14, 2.4.4-p15 releases.

Major update

commit

Added release notes for the August 2025 security patches:
- 2.4.8-p2
- 2.4.7-p7
- 2.4.6-p12
- 2.4.5-p14
- 2.4.4-p15

Major update

commit

Updated the release schedule for 2026.

Major update

commit

Added release notes for highlights introduced in 2.4.9-alpha2 Adobe Commerce and Magento Open Source.

Major update

commit

Added release notes for fixed issues introduced in 2.4.9-alpha2.

Major update

commit

Added instructions for configuring Valkey for Adobe Commerce.

New topic

commit

August 11, 2025

Description

Type

Source

Added the detailed description of the issue fixed by the ACSD-66118 patch in the QPT 1.1.67 release.

New topic, qpt

commit

Added the detailed description of the issue fixed by the AC-14984 patch in the QPT 1.1.67 release.

New topic, qpt

commit

Added the detailed description of the issue fixed by the ACSD-66072 patch in the QPT 1.1.68 release.

New topic, qpt

commit

August 8, 2025

Description

Type

Source

Added the detailed description of the issue fixed by the ACSD-66082 patch in the QPT 1.1.68 release.

New topic, qpt

commit

Added the detailed description of the issue fixed by the ACSD-66179 patch in the QPT 1.1.68 release.

New topic, qpt

commit

August 7, 2025

Description

Type

Source

Added the detailed description of the issue fixed by the AC-14985 patch in the QPT 1.1.67 release.

New topic, qpt

commit

Added the detailed description of the issue fixed by the ACSD-66049 patch in the QPT 1.1.67 release.

New topic, qpt

commit

Added the detailed description of the issue fixed by the ACSD-66084 patch in the QPT 1.1.67 release.

New topic, qpt

commit

Added the detailed description of the issue fixed by the ACSD-66441 patch in the QPT 1.1.67 release.

New topic, qpt

commit

Added the detailed description of the issue fixed by the ACSD-66233 patch in the QPT 1.1.68 release.

New topic, qpt

commit

August 5, 2025

Description

Type

Source

Added Overview: Quality Patches Tool (QPT) v1.1.68.

New topic, qpt

commit

August 4, 2025

Description

Type

Source

Added the detailed description of the issue fixed by the ACSD-66434 patch in the QPT 1.1.67 release.

New topic, qpt

commit

August 1, 2025

Description

Type

Source

Clarified shared responsibility for storefront data collection.

Major update

pull request

July 28, 2025

Description

Type

Source

Added Overview: Quality Patches Tool (QPT) v1.1.67.

New topic, qpt

commit

July 25, 2025

Description

Type

Source

Added the detailed description of the issue fixed by the ACSD-66041 patch in the QPT 1.1.66 release.

New topic, qpt

commit

Added the detailed description of the issue fixed by the ACP2E-3918 patch in the QPT 1.1.66 release.

New topic, qpt

commit

July 24, 2025

Description

Type

Source

Added the detailed description of the issue fixed by the ACSD-65848 patch in the QPT 1.1.66 release.

New topic, qpt

commit

Added the detailed description of the issue fixed by the ACSD-65913 patch in the QPT 1.1.66 release.

New topic, qpt

commit

Added a highlight about the TinyMCE version downgrade from 7 to 6.8.5 in the February 2025 security patch release notes.
- 2.4.7-p4
- 2.4.6-p9
- 2.4.5-p11
- 2.4.4-p12

Technical

commit

July 23, 2025

Description

Type

Source

Added the detailed description of the issue fixed by the ACSD-65750 patch in the QPT 1.1.66 release.

New topic, qpt

commit

Added more guidance to the on-premises installation overview to help users understand what they’re about to learn and set expectations.

Major update

commit

July 22, 2025

Description

Type

Source

Added the detailed description of the issue fixed by the ACSD-65777 patch in the QPT 1.1.66 release.

New topic, qpt

commit

July 18, 2025

Description

Type

Source

Added the detailed description of the issue fixed by the ACSD-66212 patch in the QPT 1.1.66 release.

New topic, qpt

commit

Added new Redis configuration options (--cache-backend-redis-use-lua and --cache-backend-redis-use-lua-on-gc).

Technical

commit

July 11, 2025

Description

Type

Source

Added the detailed description of the issue fixed by the ACSD-64118 patch in the QPT 1.1.65 release.

New topic, qpt

commit

Added the detailed description of the issue fixed by the ACSD-65331 patch in the QPT 1.1.65 release.

New topic, qpt

commit

Clarified the default mode for the Customer Grid indexer, which changed in 2.4.8.

Technical

commit

July 10, 2025

Description

Type

Source

Added the detailed description of the issue fixed by the ACSD-65775 patch in the QPT 1.1.66 release.

New topic, qpt

commit

July 9, 2025

Description

Type

Source

Added additional information about enabling the Application Server for Adobe Commerce on Cloud Starter projects. In particular, it adds steps for syncing stored data to the shared mount.

Major update

commit

recommendation-more-help

20c66b1f-e128-42a3-aefa-b6cce0437110