diff --git a/docs/06-installation/02-installation-guides/03-installing-in-development-mode-on-windows.md b/docs/06-installation/02-installation-guides/03-installing-in-development-mode-on-windows.md
index 675c368b5..045272d84 100644
--- a/docs/06-installation/02-installation-guides/03-installing-in-development-mode-on-windows.md
+++ b/docs/06-installation/02-installation-guides/03-installing-in-development-mode-on-windows.md
@@ -63,13 +63,17 @@ $ docker compose version
 ```
 :::
 
-8. In `{shop_name}/docker/context/php/debug/etc/php/debug.conf.d/69-xdebug.ini`, set `xdebug.remote_host` and `xdebug.client_host` to `host.docker.internal`:
+8. In `deploy.dev.yml`, set the debug configuration as follows:
 
-```text
-...
-xdebug.remote_host=host.docker.internal
-...
-xdebug.client_host=host.docker.internal
+```yaml
+docker:
+  ...
+  debug:
+    enabled: true
+    xdebug:
+      enabled: true
+      custom_host_ip: host.docker.internal
+  ...
 ```
 
 9. Add your user to the `docker` group:
diff --git a/docs/07-deploy-file/02-deploy.file.reference.v1.md b/docs/07-deploy-file/02-deploy.file.reference.v1.md
index 2ac2dde26..809a2f6f8 100644
--- a/docs/07-deploy-file/02-deploy.file.reference.v1.md
+++ b/docs/07-deploy-file/02-deploy.file.reference.v1.md
@@ -708,6 +708,7 @@ docker:
 
  ```
 * `docker: debug: xdebug: enabled:` - defines if Xdebug is enabled.
+* `docker: debug: xdebug: custom_host_ip:` - defines the custom host IP. It can be set as `host.docker.internal` when working in Windows environment with WSL2.
 
 
 ### docker: maintenance:
diff --git a/docs/09-troubleshooting.md b/docs/09-troubleshooting.md
index 39031adfc..114be57ab 100644
--- a/docs/09-troubleshooting.md
+++ b/docs/09-troubleshooting.md
@@ -271,6 +271,17 @@ docker:
       xdebug:
         enabled: true
 ```
+When working on Windows with WSL2, ensure the debug configuration is set up as follows:
+```yaml
+docker:
+  ...
+  debug:
+    enabled: true
+    xdebug:
+      enabled: true
+      custom_host_ip: host.docker.internal
+  ...
+```
 2. Ensure that IDE is listening to the port 9000.
 3. Check if the host is accessible from the container:
 ```bash
diff --git a/generator/src/templates/deploy.bash.twig b/generator/src/templates/deploy.bash.twig
index 485b64162..163d7d588 100644
--- a/generator/src/templates/deploy.bash.twig
+++ b/generator/src/templates/deploy.bash.twig
@@ -133,6 +133,7 @@ readonly SPRYKER_DEFAULT_REGION="{{ regions | keys | first }}"
 {% endif %}
 readonly SPRYKER_FILE_MODE="{{ _fileMode }}"
 readonly SPRYKER_XDEBUG_MODE_ENABLE="{{ docker['debug']['xdebug']['enabled'] is not defined or docker['debug']['xdebug']['enabled'] == true ? '1' : '' }}"
+readonly SPRYKER_CUSTOM_XDEBUG_HOST_IP="{{ docker['debug']['xdebug']['custom_host_ip'] | default('') }}"
 readonly SPRYKER_SYNC_SESSION_NAME="{{ _syncSessionName }}"
 readonly SPRYKER_SYNC_VOLUME="${SPRYKER_DOCKER_PREFIX}_${SPRYKER_DOCKER_TAG}_data_sync"
 readonly DOCKER_COMPOSE_FILES_EXTRA="{{ docker['compose']['yamls'] | default([]) | join(' ') }}"
@@ -178,7 +179,7 @@ readonly SSH_AUTH_SOCK_IN_CLI="$([ -n "${SSH_AUTH_SOCK}" ] && [ -z "${COMPOSER_A
 
 # Global variables
 readonly USER_FULL_ID=$(Environment::getFullUserId)
-readonly SPRYKER_XDEBUG_HOST_IP=$(Environment::getHostIp)
+readonly SPRYKER_XDEBUG_HOST_IP=${SPRYKER_CUSTOM_XDEBUG_HOST_IP:-$(Environment::getHostIp)}
 readonly SECRETS_ENVIRONMENT=("COMPOSER_AUTH='${COMPOSER_AUTH}'")
 
 command=${1}