Scroll to navigation

DOCKER-BUILDX-HISTORY-IMPORT(1) DOCKER-BUILDX-HISTORY-IMPORT(1)

NAME

docker-buildx-history-import - Import build records into Docker Desktop

SYNOPSIS

docker buildx history import [OPTIONS] -

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.

OPTIONS

-f, --file=[] Import from a file path

-h, --help[=false] help for import

OPTIONS INHERITED FROM PARENT COMMANDS

--builder="" Override the configured builder instance

-D, --debug[=false] Enable debug logging

EXAMPLE

### Import a `.dockerbuild` archive from standard input
```console
docker buildx history import < mybuild.dockerbuild

Import a build archive from a file (--file) {#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

```

SEE ALSO

docker-buildx-history(1)

Mar 2026