DOCKER-BUILDX-PRUNE(1)

💅 docker-buildx-prune — the "okay bestie, time to clean house" page

So like… this is part of the docker-buildx manual set (section 1, for the record 📖), and it's literally just about Remove build cache. That's it. That's the whole gig. Let's go 🧹✨

---

✨ NAME ✨

docker-buildx-prune — Remove build cache 🗑️💖

---

🌸 SYNOPSIS 🌸

docker buildx prune

---

🦋 DESCRIPTION 🦋

Clears the build cache of the selected builder. Yeah. All that accumulated ✨stuff✨ from your builds? Gone. Poof. Iconic behaviour tbh 💅

And because you're a main character who likes control, 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. 👀 (yes, the hidden ones. the backstage crew. we see them.)

---

🎀 OPTIONS 🎀

• -a, --all[=false] — Include internal/frontend images 🫣
• --filter= — Provide filter values (e.g., "until=24h") 🔍
• -f, --force[=false] — Do not prompt for confirmation (living dangerously, love that for you) 😌
• -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). Go peek at that one, bestie, it's got the lore 🫶

---

👑 SEE ALSO 👑

• docker-buildx(1)

---

no cap, if you're about to nuke your cache: check --keep-storage first so you don't delete your entire personality. your build times will thank you 🙈

---

okay that's the whole page, you ate that 💅✨ this was the DOCKER-BUILDX-PRUNE(1) page, straight from the docker-buildx source, dated Apr 2025 — love you, go clear some cache, mwah 🎀🦋