buildx/docs/reference/buildx_history.md

docker buildx history

docker buildx history [OPTIONS] COMMAND

Commands to work on build records

Subcommands

Name	Description
export	Export build records into Docker Desktop bundle
import	Import build records into Docker Desktop
inspect	Inspect a build record
logs	Print the logs of a build record
ls	List build records
open	Open a build record in Docker Desktop
rm	Remove build records
trace	Show the OpenTelemetry trace of a build record

Options

Name	Type	Default	Description
--builder	string		Override the configured builder instance
-D, --debug	bool		Enable 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