Scroll to navigation

DOCKER-BUILDX-HISTORY-RM(1) DOCKER-BUILDX-HISTORY-RM(1)

NAME

docker-buildx-history-rm - Remove build records

SYNOPSIS

docker buildx history rm [OPTIONS] [REF...]

DESCRIPTION

Remove one or more build records from the current builder’s history. You can remove specific builds by ID or offset, or delete all records at once using the --all flag.

OPTIONS

--all[=false] Remove all build records

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

OPTIONS INHERITED FROM PARENT COMMANDS

--builder="" Override the configured builder instance

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

EXAMPLE

### Remove a specific build
```console
# Using a build ID
docker buildx history rm qu2gsuo8ejqrwdfii23xkkckt
# Or using a relative offset
docker buildx history rm ^1

Remove multiple builds

# Using build IDs
docker buildx history rm qu2gsuo8ejqrwdfii23xkkckt qsiifiuf1ad9pa9qvppc0z1l3
# Or using relative offsets
docker buildx history rm ^1 ^2

Remove all build records from the current builder (--all) {#all}

docker buildx history rm --all

```

SEE ALSO

docker-buildx-history(1)

Mar 2026