Installation

P2Lab Cache is a regular Shopware 6 plugin. You install it the same way you install any other plugin — via the admin Extensions page or via Composer / the CLI.

Requirements

• Shopware 6.6 (the plugin’s composer.json constrains shopware/core, shopware/administration and shopware/storefront to >=6.6 <6.7)
• A running async message worker (bin/console messenger:consume async) for cache warming
• A backend choice — see Storage backends — and the matching infrastructure (Redis service, APCu extension or just disk space for Filesystem)

Install via the admin (ZIP upload)

1. Download the plugin ZIP (P2LabCache_vX.Y.Z.zip) from your distribution source.
2. In the Shopware admin go to Extensions → My extensions → Upload extension and pick the ZIP.
3. After upload, click Install next to the plugin entry.
4. Click Activate.
5. Clear the Shopware cache so the new HTTP cache decorator is picked up.

Install via CLI

If you have shell access to the Shopware host, copy the plugin into custom/plugins/P2LabCache and run:

bin/console plugin:refresh
bin/console plugin:install --activate P2LabCache
bin/console cache:clear

Verify the installation

1. Open the Shopware admin.
2. Go to Settings → Extensions → Speed Boost — you should land on the P2Lab Cache dashboard.
3. From the storefront, open any product page. On the second request the response should be served from cache.

To confirm a HIT, temporarily enable Debug mode in Settings → Speed Boost → Core and reload the page. The response will include:

• X-P2Lab-Cache-Status: HIT (or MISS on the first request)
• X-P2Lab-Cache-Generation-Time: <seconds>

If the headers are missing, see Troubleshooting.

Update

1. Upload the new ZIP via Extensions → My extensions → Upload extension (overwrites the existing version).
2. Run database migrations if Shopware prompts for them.
3. Clear the Shopware cache.

Cache entries from earlier versions remain valid across patch updates. Major updates may require a full Clear cache from the dashboard.

Uninstall

The plugin removes its own database tables and system-config entries during uninstall. To uninstall cleanly:

bin/console plugin:uninstall P2LabCache
bin/console cache:clear

Or use Extensions → My extensions → Uninstall from the admin.

Next: configure it

The plugin is installed but uses safe defaults that may not match your infrastructure. Continue to Quick configuration.