---
name: "docker-buildx-prune"
section: "1"
platform: "linux"
package: "docker-buildx"
version: "0.13.1+ds1-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/docker-buildx-prune"
---

# docker-buildx-prune(1)

Remove build cache

## NAME

docker-buildx-prune - Remove build cache

## SYNOPSIS

**docker buildx prune**

## DESCRIPTION

Clears the build cache of the selected builder.

You can finely control what cache data is kept using:

- •

  The **--filter=until=\<duration\>** flag to keep images that have been used in the last **\<duration\>** time.

**\<duration\>** is a duration string, e.g. **24h** or **2h30m**, with allowable\
   units of **(h)ours**, **(m)inutes** and **(s)econds**.

- •

  The **--keep-storage=\<size\>** flag to keep **\<size\>** bytes of data in the cache.

**\<size\>** is a human-readable memory string, e.g. **128mb**, **2gb**, etc. Units\
   are case-insensitive.

- •

  The **--all** flag to allow clearing internal helper images and frontend images set using the **#syntax=** directive or the **BUILDKIT\_SYNTAX** build argument.

## OPTIONS

**-a**, **--all**\[=false\]\
 	Include internal/frontend images

**--filter**=\
 	Provide filter values (e.g., "until=24h")

**-f**, **--force**\[=false\]\
 	Do not prompt for confirmation

**-h**, **--help**\[=false\]\
 	help for prune

**--keep-storage**=0\
 	Amount of disk space to keep for cache

**--verbose**\[=false\]\
 	Provide a more verbose output

## OPTIONS INHERITED FROM PARENT COMMANDS

**--builder**=""\
 	Override the configured builder instance

## EXAMPLE

```
### Override the configured builder instance (--builder) {#builder}
Same as [`buildx --builder`](/reference/cli/docker/buildx/#builder).
```

## SEE ALSO

**[docker-buildx(1)](/docker-buildx/1.md)**