buildx/docs/reference/buildx_history_import.md
sarahsanders-docker 4dac5295a1
Add descriptions and examples for buildx history commands
Signed-off-by: sarahsanders-docker <sarah.sanders@docker.com>
2025-05-05 14:32:03 -07:00

42 lines
1.2 KiB
Markdown

# docker buildx history import
<!---MARKER_GEN_START-->
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 |
<!---MARKER_GEN_END-->
## 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 into Docker Desktop
```console
docker buildx history import < mybuild.dockerbuild
```
### Import a file using a specific path
```console
docker buildx history import --file ./artifacts/backend-build.dockerbuild
```
### Import a file and open it in Docker Desktop
```console
docker buildx history import --file ./ci-build.dockerbuild && docker buildx history open ci-build
```