From dbc68b3445fabb7262cbbfaa144c8408e4d02236 Mon Sep 17 00:00:00 2001
From: shaches <69593611+shaches@users.noreply.github.com>
Date: Wed, 6 May 2026 19:58:23 +0300
Subject: [PATCH] Honor checks.disable in Docker detection test

When checks.disable is set to true, skip the socket connectivity test
in DockerClientProviderStrategy.test(). This allows Windows/WSL2 users
with working Docker to bypass the failing socket test while still
enabling Docker detection.

Fixes #4958 - TestContainers cannot detect Docker on Windows/WSL2
despite Docker being accessible via CLI and TCP.

The socket connectivity test fails on Windows/WSL2 even when Docker
is accessible via curl and CLI. By honoring the existing checks.disable
configuration, users can opt out of the connectivity test and rely on
their explicit docker.host configuration.
---
 .../dockerclient/DockerClientProviderStrategy.java          | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/core/src/main/java/org/testcontainers/dockerclient/DockerClientProviderStrategy.java b/core/src/main/java/org/testcontainers/dockerclient/DockerClientProviderStrategy.java
index 7b0aaafc169..483aa9da135 100644
--- a/core/src/main/java/org/testcontainers/dockerclient/DockerClientProviderStrategy.java
+++ b/core/src/main/java/org/testcontainers/dockerclient/DockerClientProviderStrategy.java
@@ -154,6 +154,12 @@ public DockerClient getClient() {
      */
     @UnstableAPI
     protected boolean test() {
+        // Skip connectivity test if checks are disabled (useful for Windows/WSL2)
+        if (TestcontainersConfiguration.getInstance().isDisableChecks()) {
+            log.debug("Checks are disabled, skipping Docker connectivity test");
+            return true;
+        }
+
         TransportConfig transportConfig = getTransportConfig();
         URI dockerHost = transportConfig.getDockerHost();