buildx/docs/reference/buildx_history_import.md

docker buildx history import

Import a build into Docker Desktop

Options

Name	Type	Default	Description
--builder	string		Override the configured builder instance
-D, --debug	bool		Enable debug logging
-f, --file	stringArray		Import from a file path

Description

Import a build record from a .dockerbuild archive into Docker Desktop. This lets you view, inspect, and analyze builds created in other environments or CI pipelines.

Examples

Import a .dockerbuild archive from standard input

docker buildx history import < mybuild.dockerbuild

Import a build archive from a file

docker buildx history import --file ./artifacts/backend-build.dockerbuild

Open a build manually

By default, the import command automatically opens the imported build in Docker Desktop. You don't need to run open unless you're opening a specific build or re-opening it later.

If you've imported multiple builds, you can open one manually:

docker buildx history open ci-build