DOCKER(1)

✨ NAME ✨

docker-builder-build — build an image from a Dockerfile 🫶

(and yes bestie, this is a page from the Docker User Manuals set, filed under DOCKER(1) — you're in the right place, come sit with me 💖)

---

🌸 SYNOPSIS 🌸

docker builder build [OPTIONS] PATH | URL | -

---

💅 DESCRIPTION 💅

okay so. this command builds an image from a Dockerfile. that's it, that's the whole vibe. you point it at a build context — a PATH, a URL, or - for stdin — and it goes off and makes you an image. main character energy fr fr 👑

---

🎀 OPTIONS 🎀

so many flags. literally so many. let's go one by one, no skipping, periodt:

• --add-host= — add a custom host-to-IP mapping, written as "host:ip". lowkey essential when you need a name to resolve to a specific address.
• --build-arg= — set build-time variables. like env vars but just for the build, iykyk.
• --cache-from=[] — images to consider as cache sources. yes queen, reuse that cache.
• --cgroup-parent="" — set the parent cgroup for the "RUN" instructions during build.
• --compress[=false] — compress the build context using gzip. defaults to false.
• --cpu-period=0 — limit the CPU CFS (Completely Fair Scheduler) period.
• --cpu-quota=0 — limit the CPU CFS (Completely Fair Scheduler) quota.
• -c, --cpu-shares=0 — CPU shares (relative weight).
• --cpuset-cpus="" — CPUs in which to allow execution, like 0-3 or 0,1.
• --cpuset-mems="" — MEMs in which to allow execution, like 0-3 or 0,1.
• -f, --file="" — name of the Dockerfile (default is "PATH/Dockerfile").
• --force-rm[=false] — always remove intermediate containers. no leftovers, we love a clean room 🧹
• --iidfile="" — write the image ID to the file. handy for scripts!
• --isolation="" — container isolation technology.
• --label= — set metadata for an image. cute lil name tags 🏷️
• -m, --memory=0 — memory limit.
• --memory-swap=0 — swap limit equal to memory plus swap: -1 to enable unlimited swap.
• --network="default" — set the networking mode for the RUN instructions during build.
• --no-cache[=false] — do not use cache when building the image. fresh start energy ✨
• --platform="" — set platform if server is multi-platform capable.
• --pull[=false] — always attempt to pull a newer version of the image.
• -q, --quiet[=false] — suppress the build output and print image ID on success. the strong silent type 💀
• --rm[=true] — remove intermediate containers after a successful build. (on by default, bestie — note the true)
• --security-opt=[] — security options.
• --shm-size=0 — size of "/dev/shm".
• --squash[=false] — squash newly built layers into a single new layer.
• -t, --tag= — name and optionally a tag in the "name:tag" format.
• --target="" — set the target build stage to build.
• --ulimit=[] — Ulimit options.

---

🦋 SEE ALSO 🦋

• docker-builder(1)

---

ngl, if you're ever lost, just run it with --help and vibe check your way through. you got this 💜

---

mwah 💖 that's the whole page! brought to you by the Docker Community, dated Oct 2026 — thanks for reading all the way to the bottom, you're literally iconic for that 👑🌸