DOCKER-COMPOSE-BUILD(1)

📦 version 2.26.1, in debian trixie

💅 docker-compose-build — bestie edition 💅

okay so you wanna know about docker-compose-build? it's the one that builds or rebuilds your services and honestly? it's giving main character energy. let's get into it 🫶

✨ SYNOPSIS ✨

docker compose build [OPTIONS] [SERVICE...]

that's it. that's the whole vibe. you point it at some services (or don't, and it does all of them, iykyk) and it goes to work 🔥

🦋 DESCRIPTION 🦋

so here's the tea ☕ — services get built once, and then they get tagged. by default that tag is project-service. periodt.

but wait, if your Compose file specifies an image name (like, the actual spec one over at https://github.com/compose-spec/compose-spec/blob/master/spec.md#image), then the image gets tagged with that name instead, and any variables get substituted beforehand. variable interpolation deets live here: https://github.com/compose-spec/compose-spec/blob/master/spec.md#interpolation ✨

and like, if you go and change a service's Dockerfile, or literally anything in its build directory? you gotta run docker compose build again to rebuild it. no shortcuts bestie, it won't notice on its own 😭

👑 OPTIONS 👑

  • --build-arg=[] — set build-time variables for services 💖
  • --builder="" — pick which builder to use
  • -h, --help[=false] — the help for build. classic.
  • -m, --memory=0 — set a memory limit for the build container. ⚠️ heads up: not supported by BuildKit. ngl that one matters.
  • --no-cache[=false] — do NOT use the cache when building the image. fresh start energy 🌸
  • --pull[=false] — always attempt to pull a newer version of the image. gotta stay current ✨
  • --push[=false] — push service images 🚀
  • -q, --quiet[=false] — don't print anything to STDOUT. silent but deadly 💀
  • --ssh="" — set SSH authentications used when building service images. (use 'default' for using your default SSH Agent) 🔑
  • --with-dependencies[=false] — also build dependencies, transitively. bring the whole friend group 🫶

🌈 OPTIONS INHERITED FROM PARENT COMMANDS 🌈

  • --dry-run[=false] — execute command in dry run mode. it's giving ✨rehearsal✨, nothing actually happens.

🌸 SEE ALSO 🌸

k that's the whole page bestie, go build something iconic 🎀

mwah 💋 — this was the DOCKER-COMPOSE-BUILD(1) manual page, Mar 2025 edition, straight from the docker-compose-build source. slay responsibly.

📦 where this page comes from