docker / docker/buildx

Migrate from github.com/docker/docker to github.com/moby/moby/client (v29 module path change)

Open
#3,792 3 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Go
Stars
4.5k
Forks
682
Avg merge
2d 14h
Merged PRs (30d)
29

Description

This module still imports github.com/docker/docker, which was deprecated in Docker Engine v29.0.0 in favour of github.com/moby/moby/client and github.com/moby/moby/api.

As noted in the v29.0.0 release notes:

The Go module github.com/docker/docker is deprecated in favor of github.com/moby/moby/client and github.com/moby/moby/api.

Because docker/buildx has not yet migrated, any Go project that transitively depends on docker/buildx (e.g. via testcontainers-go/modules/compose) is forced to carry github.com/docker/docker in its module graph. This is now causing security scanner alerts for CVE-2026-34040 and CVE-2026-33997, both fixed in moby/moby v29.3.1+ but only accessible via the new module path.

The dependency chain I'm currently facing issues with is for github.com/docker/docker v28.5.2+incompatible:

testcontainers-go/modules/compose
  └─ docker/compose/v5/pkg/compose
      └─ docker/buildx/store/storeutil
          └─ docker/buildx/store
              └─ github.com/docker/docker

There is no workaround available to downstream consumers — a replace directive cannot bridge a module path rename, and github.com/docker/docker stops at v28 on the Go module proxy.

Are there plans to migrate this module to use github.com/moby/moby/client and github.com/moby/moby/api instead of github.com/docker/docker, so that downstream projects can resolve these CVEs ?

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by tracing the imports and Go module graph through buildx/store/storeutil and buildx/store, focusing on github.com/docker/docker and the proposed github.com/moby/moby/client and github.com/moby/moby/api paths. Done means docker/buildx no longer forces github.com/docker/docker v28.5.2+incompatible, and downstream projects can resolve the dependency versions containing the cited fixes.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker, go
Domain
build-system
Issue type
Refactor
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.