From 8473610df9e6b14a63288f9e56f59e8f582f9a7d Mon Sep 17 00:00:00 2001 From: Jakub Rudnik <56173355+Jakub-Rudnik@users.noreply.github.com> Date: Tue, 17 Feb 2026 09:14:50 +0100 Subject: [PATCH 1/2] Document Xdebug Docker setup for Linux Added instructions for additional necessary Xdebug Docker settings to work on Linux. --- guides/installation/setups/docker-options.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/guides/installation/setups/docker-options.md b/guides/installation/setups/docker-options.md index 2835078d0..041fb2038 100644 --- a/guides/installation/setups/docker-options.md +++ b/guides/installation/setups/docker-options.md @@ -42,6 +42,17 @@ docker compose up -d This restarts the containers with Xdebug enabled. You can now attach your IDE (for example, PHPStorm or VS Code) to the remote debugger on the default Xdebug port `9003`. +## Xdebug on Linux + +To enable Xdebug connectivity on Linux, you must manually map the host.docker.internal hostname to the Docker host gateway. Add the following configuration to your `compose.override.yaml`: + +```yaml +services: + web: + extra_hosts: + - "host.docker.internal:host-gateway" +``` + Shopware’s Docker setup also supports other profilers, like [Blackfire](https://www.blackfire.io/), [Tideways](https://tideways.com/), and [PCOV](https://github.com/krakjoe/pcov). For Tideways and Blackfire, you'll need to run an additional container. For example: ```yaml From d497ab37bf12d4d5e0d1c392abfdc0588a1feda4 Mon Sep 17 00:00:00 2001 From: Shyim Date: Tue, 17 Feb 2026 10:31:32 +0100 Subject: [PATCH 2/2] Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- guides/installation/setups/docker-options.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guides/installation/setups/docker-options.md b/guides/installation/setups/docker-options.md index 041fb2038..4cbdb0a09 100644 --- a/guides/installation/setups/docker-options.md +++ b/guides/installation/setups/docker-options.md @@ -42,14 +42,14 @@ docker compose up -d This restarts the containers with Xdebug enabled. You can now attach your IDE (for example, PHPStorm or VS Code) to the remote debugger on the default Xdebug port `9003`. -## Xdebug on Linux +### Xdebug on Linux To enable Xdebug connectivity on Linux, you must manually map the host.docker.internal hostname to the Docker host gateway. Add the following configuration to your `compose.override.yaml`: ```yaml services: web: - extra_hosts: + extra_hosts: - "host.docker.internal:host-gateway" ```