Skip to content

Performance Suite Bundle: Complete Performance Optimization in One Package

User Guide

CopeX GmbH
Web: https://copex.io
Email: office@copex.io

Inhaltsverzeichnis / Table of Contents

Abschnitt / Section Seite
1 Was es macht / What it does 3
2 Wann sinnvoll / When to use 3
3 Voraussetzungen / Requirements 4
4 Installation 4
5 Aktivierung / Activation 5
6 Verwendung / Usage 5
7 Was tun bei Problemen / Troubleshooting 7

1 What it does

Performance Suite Bundle is a Composer meta-package — it contains no code of its own. With a single command, it installs all six CopeX performance packages:

Package Purpose
copex/module-performance-suite Core infrastructure, CLI, kill switches
copex/module-preloaders (Smart Loaders) Batch pre-loading of product and cart data
copex/module-build-config (Config Cache) Pre-compile configuration at deploy time
copex/module-layout-precompile (Layout Cache) Warm up layout cache at deploy time
copex/build-compiler Technical foundation for compilation
copex/module-performance-tweaks (Cache Tweaks) Reduce Redis layout cache via generic handles

All included modules can be activated and deactivated independently.

2 When to use

  • All CopeX performance modules should be installed at once
  • One composer require instead of six separate packages

3 Requirements

  • Magento 2.4.6 or higher
  • PHP 8.1 or higher (compatible with 8.2, 8.3, 8.4, 8.5)
  • copex/module-core >1.1.0
  • CopeX package repository in composer.json

4 Installation

Add the CopeX package repository to your composer.json if not already present:

{
    "repositories": [
        {
            "type": "composer",
            "url": "https://packages.copex.io"
        }
    ]
}

Install the bundle:

composer require copex/performance-suite-bundle

Enable all Magento modules and run setup:

bin/magento module:enable CopeX_PerformanceSuite CopeX_Preloaders CopeX_BuildConfig CopeX_LayoutPrecompile CopeX_Performance
bin/magento setup:upgrade
bin/magento cache:flush

5 Activation

The bundle itself has no configuration. All features are controlled via app/etc/env.php:

'copex' => [
    'performance' => [
        'enabled' => true,
        'preloaders_enabled' => true,
    ],
    'build' => [
        'enabled' => true,
        'config_enabled' => true,
    ],
],

6 Usage

After activation, run the build commands to prepare configuration and layout cache:

bin/magento copex:performance:build:config
bin/magento copex:performance:build
bin/magento cache:flush

Add these commands to your deployment pipeline — after setup:upgrade and setup:static-content:deploy, before cache:flush.

Health check after deployment:

bin/magento copex:performance:recommendations

7 Troubleshooting

Complete kill switch — disable all modules immediately:

'copex' => [
    'performance' => ['enabled' => false],
    'build' => ['enabled' => false],
],

Set in env.php. Takes effect on the next request — no cache flush, no server restart required. The shop immediately runs as it did before installation.

Individual module documentation: vendor/copex/<package-name>/docs/EN.md for Performance Suite, Smart Loaders, Config Cache, Build Compiler, and Cache Tweaks.

CopeX GmbH — Web: https://copex.io — Email: office@copex.io