DOCKER(1)

💅 DOCKER(1) — bestie edition 🎀

okay so before we even get into it: this is page one of the Docker User Manuals, and today's main character is docker-builder-prune. buckle up, it's giving spring cleaning 🧹✨

---

🌸 NAME 🌸

docker-builder-prune — Remove build cache

like literally, that's the whole vibe. it removes your build cache. no cap. 💖

---

✨ SYNOPSIS ✨

docker builder prune

that's it. that's the whole spell. type it, and watch your disk breathe again 🦋

---

🫶 DESCRIPTION 🫶

Remove build cache

periodt. that's the description, fr fr. your build cache has been hoarding disk space like it's collecting squishmallows, and this command is the vibe check that sends it on its way 💅

---

👑 OPTIONS 👑

four options. four little sliders. let's go one by one because i love you and i want you to know exactly what each one does 🔥

• -a, --all[=false] — Remove all unused build cache, not just dangling ones. so by default you're only yeeting the dangling stuff, but turn this on and it's a full-on closet cleanout. everything unused is going 🗑️✨
• --filter= — Provide filter values (e.g. "until=24h"). you wanna be picky? you can be picky. this is how you tell it what to prune instead of just nuking everything 🎯
• -f, --force[=false] — Do not prompt for confirmation. normally it asks you first, like a polite friend checking in. this flag says "no questions, i know what i'm doing" 😤💀
• --keep-storage=0 — Amount of disk space to keep for cache. the default is 0, meaning you're keeping nothing. give it a value and it'll spare that much cache so you're not starting from zero every single time 🍓

heads up bestie: --keep-storage=0 is the default, so if you don't pass anything, it's keeping literally zero cache. plan accordingly 🙈

---

🌈 SEE ALSO 🌈

docker-builder(1) — go read the parent page, it's iconic too 👑

---

and that's the whole page!! every flag, every default, every reference, all accounted for 💜

Docker Community wrote this, it's dated Oct 2026, and it lives in the DOCKER(1) section of the manual. mwah. take care of your disk and drink some water 🫶💖🎀