buildx/docs/reference/buildx_history_export.md

docker buildx history export

Export build records into Docker Desktop bundle

Options

Name	Type	Default	Description
--all	bool		Export all build records for the builder
--builder	string		Override the configured builder instance
-D, --debug	bool		Enable debug logging
--finalize	bool		Ensure build records are finalized before exporting
-o, --output	string		Output file path

Description

Export one or more build records to .dockerbuild archive files. These archives contain metadata, logs, and build outputs, and can be imported into Docker Desktop or shared across environments.

Examples

Export all build records to a file (--all)

Use the --all flag and redirect the output:

docker buildx history export --all > all-builds.dockerbuild

Or use the --output flag:

docker buildx history export --all -o all-builds.dockerbuild

Use a specific builder instance (--builder)

docker buildx history export --builder builder0 ^1 -o builder0-build.dockerbuild

Enable debug logging (--debug)

docker buildx history export --debug qu2gsuo8ejqrwdfii23xkkckt -o debug-build.dockerbuild

Ensure build records are finalized before exporting (--finalize)

Clients can report their own traces concurrently, and not all traces may be saved yet by the time of the export. Use the --finalize flag to ensure all traces are finalized before exporting.

docker buildx history export --finalize qu2gsuo8ejqrwdfii23xkkckt -o finalized-build.dockerbuild

Export a single build to a custom file (--output)

docker buildx history export qu2gsuo8ejqrwdfii23xkkckt --output mybuild.dockerbuild

You can find build IDs by running:

docker buildx history ls

To export two builds to separate files:

# Using build IDs
docker buildx history export qu2gsuo8ejqrwdfii23xkkckt qsiifiuf1ad9pa9qvppc0z1l3 -o multi.dockerbuild

# Or using relative offsets
docker buildx history export ^1 ^2 -o multi.dockerbuild

Or use shell redirection:

docker buildx history export ^1 > mybuild.dockerbuild
docker buildx history export ^2 > backend-build.dockerbuild