[Bug]: Basic example from docs throw exception: Method not found: 'Docker.DotNet.DockerClient...'

[vitaliiopticom]

Testcontainers version

4.4

Using the latest Testcontainers version?

Yes

Host OS

MacOS 15.14.1

Host arch

ARM

.NET version

8.0.407

Docker version

Client:
 Version:           28.0.4
 API version:       1.48
 Go version:        go1.23.7
 Git commit:        b8034c0
 Built:             Tue Mar 25 15:06:09 2025
 OS/Arch:           darwin/arm64
 Context:           desktop-linux

Server: Docker Desktop 4.40.0 (187762)
 Engine:
  Version:          28.0.4
  API version:      1.48 (minimum version 1.24)
  Go version:       go1.23.7
  Git commit:       6430e49
  Built:            Tue Mar 25 15:07:18 2025
  OS/Arch:          linux/arm64
  Experimental:     false
 containerd:
  Version:          1.7.26
  GitCommit:        753481ec61c7c8955a23d6ff7bc8e4daed455734
 runc:
  Version:          1.2.5
  GitCommit:        v1.2.5-0-g59923ef
 docker-init:
  Version:          0.19.0
  GitCommit:        de40ad0

Docker info

Client:
 Version:    28.0.4
 Context:    desktop-linux
 Debug Mode: false
 Plugins:
  ai: Docker AI Agent - Ask Gordon (Docker Inc.)
    Version:  v1.1.3
    Path:     /Users/admin/.docker/cli-plugins/docker-ai
  buildx: Docker Buildx (Docker Inc.)
    Version:  v0.22.0-desktop.1
    Path:     /Users/admin/.docker/cli-plugins/docker-buildx
  cloud: Docker Cloud (Docker Inc.)
    Version:  0.2.20
    Path:     /Users/admin/.docker/cli-plugins/docker-cloud
  compose: Docker Compose (Docker Inc.)
    Version:  v2.34.0-desktop.1
    Path:     /Users/admin/.docker/cli-plugins/docker-compose
  debug: Get a shell into any image or container (Docker Inc.)
    Version:  0.0.38
    Path:     /Users/admin/.docker/cli-plugins/docker-debug
  desktop: Docker Desktop commands (Beta) (Docker Inc.)
    Version:  v0.1.6
    Path:     /Users/admin/.docker/cli-plugins/docker-desktop
  dev: Docker Dev Environments (Docker Inc.)
    Version:  v0.1.2
    Path:     /Users/admin/.docker/cli-plugins/docker-dev
  extension: Manages Docker extensions (Docker Inc.)
    Version:  v0.2.27
    Path:     /Users/admin/.docker/cli-plugins/docker-extension
  init: Creates Docker-related starter files for your project (Docker Inc.)
    Version:  v1.4.0
    Path:     /Users/admin/.docker/cli-plugins/docker-init
  model: Docker Model Runner (Docker Inc.)
    Version:  v0.1.4
    Path:     /Users/admin/.docker/cli-plugins/docker-model
  sbom: View the packaged-based Software Bill Of Materials (SBOM) for an image (Anchore Inc.)
    Version:  0.6.0
    Path:     /Users/admin/.docker/cli-plugins/docker-sbom
  scout: Docker Scout (Docker Inc.)
    Version:  v1.17.0
    Path:     /Users/admin/.docker/cli-plugins/docker-scout
WARNING: Plugin "/Users/admin/.docker/cli-plugins/docker-feedback" is not valid: failed to fetch metadata: fork/exec /Users/admin/.docker/cli-plugins/docker-feedback: no such file or directory

Server:
 Containers: 3
  Running: 1
  Paused: 0
  Stopped: 2
 Images: 30
 Server Version: 28.0.4
 Storage Driver: overlayfs
  driver-type: io.containerd.snapshotter.v1
 Logging Driver: json-file
 Cgroup Driver: cgroupfs
 Cgroup Version: 2
 Plugins:
  Volume: local
  Network: bridge host ipvlan macvlan null overlay
  Log: awslogs fluentd gcplogs gelf journald json-file local splunk syslog
 CDI spec directories:
  /etc/cdi
  /var/run/cdi
 Swarm: inactive
 Runtimes: io.containerd.runc.v2 runc
 Default Runtime: runc
 Init Binary: docker-init
 containerd version: 753481ec61c7c8955a23d6ff7bc8e4daed455734
 runc version: v1.2.5-0-g59923ef
 init version: de40ad0
 Security Options:
  seccomp
   Profile: unconfined
  cgroupns
 Kernel Version: 6.10.14-linuxkit
 Operating System: Docker Desktop
 OSType: linux
 Architecture: aarch64
 CPUs: 12
 Total Memory: 13.39GiB
 Name: docker-desktop
 ID: 0b3aa4d3-3a73-4838-89cf-1cfae2bb9845
 Docker Root Dir: /var/lib/docker
 Debug Mode: false
 HTTP Proxy: http.docker.internal:3128
 HTTPS Proxy: http.docker.internal:3128
 No Proxy: hubproxy.docker.internal
 Labels:
  com.docker.desktop.address=unix:///Users/admin/Library/Containers/com.docker.docker/Data/docker-cli.sock
 Experimental: false
 Insecure Registries:
  hubproxy.docker.internal:5555
  ::1/128
  127.0.0.0/8
 Live Restore Enabled: false

What happened?

Copy/paste example from docs

// Create a new instance of a container.

using System.Diagnostics;
using DotNet.Testcontainers.Builders;

var container = new ContainerBuilder()
    // Set the image for the container to "testcontainers/helloworld:1.2.0".
    .WithImage("testcontainers/helloworld:1.2.0")
    // Bind port 8080 of the container to a random port on the host.
    .WithPortBinding(8080, true)
    // Wait until the HTTP endpoint of the container is available.
    .WithWaitStrategy(Wait.ForUnixContainer().UntilHttpRequestIsSucceeded(r => r.ForPort(8080)))
    // Build the container configuration.
    .Build();

// Start the container.
await container.StartAsync()
    .ConfigureAwait(false);

// Create a new instance of HttpClient to send HTTP requests.
using var httpClient = new HttpClient();

// Construct the request URI by specifying the scheme, hostname, assigned random host port, and the endpoint "uuid".
var requestUri = new UriBuilder(Uri.UriSchemeHttp, container.Hostname, container.GetMappedPublicPort(8080), "uuid").Uri;

// Send an HTTP GET request to the specified URI and retrieve the response as a string.
var guid = await httpClient.GetStringAsync(requestUri)
    .ConfigureAwait(false);

// Ensure that the retrieved UUID is a valid GUID.
Debug.Assert(Guid.TryParse(guid, out _));

throw an exception

System.MissingMethodException: Method not found: 'Docker.DotNet.DockerClient Docker.DotNet.DockerClientConfiguration.CreateClient(System.Version)'.
   at DotNet.Testcontainers.Builders.DockerEndpointAuthenticationProvider.<>c__DisplayClass2_0.<<IsAvailable>b__0>d.MoveNext()
   at System.Runtime.CompilerServices.AsyncMethodBuilderCore.Start[TStateMachine](TStateMachine& stateMachine)
   at DotNet.Testcontainers.Builders.DockerEndpointAuthenticationProvider.<>c__DisplayClass2_0.<IsAvailable>b__0()
   at System.Threading.Tasks.Task`1.InnerInvoke()
   at System.Threading.ExecutionContext.RunFromThreadPoolDispatchLoop(Thread threadPoolThread, ExecutionContext executionContext, ContextCallback callback, Object state)
--- End of stack trace from previous location ---
   at System.Threading.ExecutionContext.RunFromThreadPoolDispatchLoop(Thread threadPoolThread, ExecutionContext executionContext, ContextCallback callback, Object state)
   at System.Threading.Tasks.Task.ExecuteWithThreadLocal(Task& currentTaskSlot, Thread threadPoolThread)
--- End of stack trace from previous location ---
   at DotNet.Testcontainers.Builders.DockerEndpointAuthenticationProvider.IsAvailable() in /_/src/Testcontainers/Builders/DockerEndpointAuthenticationProvider.cs:line 30
   at DotNet.Testcontainers.Configurations.TestcontainersSettings.<>c.<.cctor>b__2_1(IDockerEndpointAuthenticationProvider authProvider) in /_/src/Testcontainers/Configurations/TestcontainersSettings.cs:line 34
   at System.Linq.Enumerable.TryGetFirst[TSource](IEnumerable`1 source, Func`2 predicate, Boolean& found)
   at System.Linq.Enumerable.FirstOrDefault[TSource](IEnumerable`1 source, Func`2 predicate)
   at DotNet.Testcontainers.Configurations.TestcontainersSettings..cctor() in /_/src/Testcontainers/Configurations/TestcontainersSettings.cs:line 21

Relevant log output

Additional information

No response

[HofmeisterAn]

Are you mixing different Testcontainers or Docker.DotNet versions? Can you please share the package references?

[vitaliiopticom]

Ok, now i can reproduce. I'm using paket to manage dependecies.

paket.dependencies

source https://api.nuget.org/v3/index.json

framework: net8.0
storage: none
nuget Testcontainers

so when i install dependencies dotnet paket install i have a paket.lock

STORAGE: NONE
RESTRICTION: == net8.0
NUGET
  remote: https://api.nuget.org/v3/index.json
    BouncyCastle.Cryptography (2.5.1)
    Docker.DotNet.Enhanced (3.127)
      Microsoft.Extensions.Logging.Abstractions (>= 8.0.3)
      System.IO.Pipelines (>= 8.0)
    Docker.DotNet.Enhanced.X509 (3.127)
      Docker.DotNet.Enhanced (>= 3.127)
    Microsoft.Extensions.DependencyInjection.Abstractions (9.0.4)
    Microsoft.Extensions.Logging.Abstractions (9.0.4)
      Microsoft.Extensions.DependencyInjection.Abstractions (>= 9.0.4)
      System.Diagnostics.DiagnosticSource (>= 9.0.4)
    SharpZipLib (1.4.2)
    SSH.NET (2024.2)
      BouncyCastle.Cryptography (>= 2.4)
    System.Diagnostics.DiagnosticSource (9.0.4)
    System.IO.Pipelines (9.0.4)
    Testcontainers (4.4)
      Docker.DotNet.Enhanced (>= 3.126.1)
      Docker.DotNet.Enhanced.X509 (>= 3.126.1)
      Microsoft.Extensions.Logging.Abstractions (>= 8.0.3)
      SharpZipLib (>= 1.4.2)
      SSH.NET (>= 2024.2)

where Docker.DotNet.Enhanced (3.127) cost a problem. If i downgrade manually to 3.126.1

source https://api.nuget.org/v3/index.json

framework: net8.0
storage: none
nuget Testcontainers
nuget Docker.DotNet.Enhanced = 3.126.1

it works.

[landy]

Yes, I have the same issue. And I can confirm that downgrading to 3.126.1 fixes the issue

[HofmeisterAn]

You cannot simply upgrade a transitive dependency and expect it to work. The new version of Docker.DotNet is somewhat experimental and not yet compatible with the current version of Testcontainers. This will take a few more days. But of course, we can set the version range to mitigate the issue (I will do that in the next version 👍).

[vitaliiopticom]

I didn't update dependencies by myself. I just used one command.

dotnet paket add Testcontainers

[HofmeisterAn]

👍 It's likely that Paket choose the latest version instead of the one included in Testcontainers. IIRC, we had this issue before.

[HofmeisterAn]

Thank you for creating the issue. I will close this issue in favor of the one referenced above ☝️, where we can discuss how to address it. BTW, there is a fallback mechanism in Pakt that behaves like NuGet.