github.com/moby/buildkit breaking changes
Every breaking API change we have recorded in github.com/moby/buildkit on Go modules: 58 breaking changes in 3 versions. Below are its newest 3 versions, removals and renames first, each with its source.
Newest change July 27, 2026

On this page
v0.32.0
- Signature changed
github.com/moby/buildkit/exporter/containerimage.ImageCommitOpts.OCIArtifact
Was OCIArtifact bool; now OCIArtifact *bool. pkg.go.dev - Signature changed
github.com/moby/buildkit/frontend/attestations/sbom.CreateSBOMScanner
Was func CreateSBOMScanner(context.Context, sourceresolver.MetaResolver, string, sourceresolver.Opt, map[string]string) (Scanner, error); now func CreateSBOMScanner(context.Context, sourceresolver.MetaResolver, string, ocispecs.Platform... pkg.go.dev - Signature changed
github.com/moby/buildkit/session/exporter/exporterprovider.New
Was func New(Callback) *Exporter; now func New(Callback, ...Option) *Exporter. pkg.go.dev - Signature changed
github.com/moby/buildkit/solver/llbsolver/proc.SBOMProcessor
Was func SBOMProcessor(string, bool, string, map[string]string) llbsolver.Processor; now func SBOMProcessor(string, ocispecs.Platform, bool, string, map[string]string) llbsolver.Processor. pkg.go.dev
v0.31.0
- Removed
github.com/moby/buildkit/exporter/containerimage.ImageCommitOpts.EnableForceCompression
github.com/moby/buildkit/exporter/containerimage.ImageCommitOpts.EnableForceCompression was removed in github.com/moby/buildkit v0.31.0 pkg.go.dev - Removed
github.com/moby/buildkit/exporter/containerimage.ImageCommitOpts.EnableOCITypes
github.com/moby/buildkit/exporter/containerimage.ImageCommitOpts.EnableOCITypes was removed in github.com/moby/buildkit v0.31.0 pkg.go.dev - Signature changed
github.com/moby/buildkit/api/services/control.BuildHistoryRecord.CompletedAt
Was CompletedAt *timestamp.Timestamp; now CompletedAt *timestamppb.Timestamp. pkg.go.dev - Signature changed
github.com/moby/buildkit/api/services/control.BuildHistoryRecord.CreatedAt
Was CreatedAt *timestamp.Timestamp; now CreatedAt *timestamppb.Timestamp. pkg.go.dev - Signature changed
github.com/moby/buildkit/api/services/control.BuildHistoryRecord.GetCompletedAt
Was func GetCompletedAt() *timestamp.Timestamp; now func GetCompletedAt() *timestamppb.Timestamp. pkg.go.dev - Signature changed
github.com/moby/buildkit/api/services/control.BuildHistoryRecord.GetCreatedAt
Was func GetCreatedAt() *timestamp.Timestamp; now func GetCreatedAt() *timestamppb.Timestamp. pkg.go.dev - Signature changed
github.com/moby/buildkit/api/services/control.UsageRecord.CreatedAt
Was CreatedAt *timestamp.Timestamp; now CreatedAt *timestamppb.Timestamp. pkg.go.dev - Signature changed
github.com/moby/buildkit/api/services/control.UsageRecord.GetCreatedAt
Was func GetCreatedAt() *timestamp.Timestamp; now func GetCreatedAt() *timestamppb.Timestamp. pkg.go.dev - Signature changed
github.com/moby/buildkit/api/services/control.UsageRecord.GetLastUsedAt
Was func GetLastUsedAt() *timestamp.Timestamp; now func GetLastUsedAt() *timestamppb.Timestamp. pkg.go.dev - Signature changed
github.com/moby/buildkit/api/services/control.UsageRecord.LastUsedAt
Was LastUsedAt *timestamp.Timestamp; now LastUsedAt *timestamppb.Timestamp. pkg.go.dev
And 28 more in this version.
v0.30.0
- Removed
github.com/moby/buildkit/client.SolveOpt.LocalDirs
github.com/moby/buildkit/client.SolveOpt.LocalDirs was removed in github.com/moby/buildkit v0.30.0 pkg.go.dev - Removed
github.com/moby/buildkit/frontend/dockerui.Client.Epoch
github.com/moby/buildkit/frontend/dockerui.Client.Epoch was removed in github.com/moby/buildkit v0.30.0 pkg.go.dev - Removed
github.com/moby/buildkit/frontend/dockerui.Config.Epoch
github.com/moby/buildkit/frontend/dockerui.Config.Epoch was removed in github.com/moby/buildkit v0.30.0 pkg.go.dev - Removed
github.com/moby/buildkit/solver/llbsolver/provenance.Capture.Args
github.com/moby/buildkit/solver/llbsolver/provenance.Capture.Args was removed in github.com/moby/buildkit v0.30.0 pkg.go.dev - Removed
github.com/moby/buildkit/solver/llbsolver/provenance.Capture.Frontend
github.com/moby/buildkit/solver/llbsolver/provenance.Capture.Frontend was removed in github.com/moby/buildkit v0.30.0 pkg.go.dev - Removed
github.com/moby/buildkit/solver/llbsolver/provenance.Capture.Secrets
github.com/moby/buildkit/solver/llbsolver/provenance.Capture.Secrets was removed in github.com/moby/buildkit v0.30.0 pkg.go.dev - Removed
github.com/moby/buildkit/solver/llbsolver/provenance.Capture.SSH
github.com/moby/buildkit/solver/llbsolver/provenance.Capture.SSH was removed in github.com/moby/buildkit v0.30.0 pkg.go.dev - Removed
github.com/moby/buildkit/util/tracing/env
github.com/moby/buildkit/util/tracing/env was removed in github.com/moby/buildkit v0.30.0 pkg.go.dev - Removed
github.com/moby/buildkit/util/tracing/exec
github.com/moby/buildkit/util/tracing/exec was removed in github.com/moby/buildkit v0.30.0 pkg.go.dev - Renamed
github.com/moby/buildkit/util/tracing/exec.Environ
Use github.com/moby/buildkit/util/tracing/childprocess.Environ instead. pkg.go.dev
And 6 more in this version.
Check your code
These are the changes. To see which of them reach your code, scan a public repository, or have your coding agent call check_code with your manifest or lockfile over MCP. The API reads every change in every version, not only the newest. On Team and up, a fix pull request opens for the changes that reach a connected repository. Nothing merges or deploys.

Put your code on continuous management.
Scan a public repository now, or give your agent one line.
See how out of date your code is.
Tell your agent what changed since it was trained.
claude mcp add --transport http since https://api.since.dev/mcp