docker buildx history

May 13, 2025 ยท View on GitHub

docker buildx history [OPTIONS] COMMAND

Commands to work on build records

Subcommands

NameDescription
exportExport build records into Docker Desktop bundle
importImport build records into Docker Desktop
inspectInspect a build record
logsPrint the logs of a build record
lsList build records
openOpen a build record in Docker Desktop
rmRemove build records
traceShow the OpenTelemetry trace of a build record

Options

NameTypeDefaultDescription
--builderstringOverride the configured builder instance
-D, --debugboolEnable debug logging

Build references

Most buildx history subcommands accept a build reference to identify which build to act on. You can specify the build in two ways:

  • By build ID, fetched by docker buildx history ls:

    docker buildx history export qu2gsuo8ejqrwdfii23xkkckt --output build.dockerbuild
    
  • By relative offset, to refer to recent builds:

    docker buildx history export ^1 --output build.dockerbuild
    
    • ^0 or no reference targets the most recent build
    • ^1 refers to the build before the most recent
    • ^2 refers to two builds back, and so on

Offset references are supported in the following buildx history commands:

  • logs
  • inspect
  • open
  • trace
  • export
  • rm