Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 33 additions & 3 deletions content/manuals/engine/manage-resources/pruning.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,12 @@
---
description: Free up disk space by removing unused resources with the prune command
keywords: pruning, prune, images, volumes, containers, networks, disk, administration,
keywords:
pruning, prune, images, volumes, containers, networks, disk, administration,
garbage collection
title: Prune unused Docker objects
aliases:
- /engine/admin/pruning/
- /config/pruning/
- /engine/admin/pruning/
- /config/pruning/
---

Docker takes a conservative approach to cleaning up unused objects (often
Expand Down Expand Up @@ -143,6 +144,35 @@ Other filtering expressions are available. See the
[`docker network prune` reference](/reference/cli/docker/network/prune/)
for more examples.

## Prune build cache

The build cache is used by the BuildKit builder to speed up subsequent builds.
Over time, this cache can grow large. Use `docker builder prune` to remove
dangling build cache — cache that isn't associated with any current build:

```console
$ docker builder prune

WARNING! This will remove all dangling build cache.
Are you sure you want to continue? [y/N] y
```

By default, you're prompted to continue. To bypass the prompt, use the `-f` or
`--force` flag.

To remove all build cache, not just dangling cache, use the `--all` flag:

```console
$ docker builder prune --all

WARNING! This will remove all build cache.
Are you sure you want to continue? [y/N] y
```

Other filtering expressions are available. See the
[`docker builder prune` reference](/reference/cli/docker/builder/prune/)
for more examples.

## Prune everything

The `docker system prune` command is a shortcut that prunes images, containers,
Expand Down
Loading