---
name: "docker-compose-build"
section: "1"
platform: "linux"
package: "docker-compose"
version: "2.26.1-4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/docker-compose-build"
---

# docker-compose-build(1)

Build or rebuild services

## NAME

docker-compose-build - Build or rebuild services

## SYNOPSIS

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

## DESCRIPTION

Services are built once and then tagged, by default as **project-service**.

If the Compose file specifies an image ⟨https://github.com/compose-spec/compose-spec/blob/master/spec.md#image⟩ name, the image is tagged with that name, substituting any variables beforehand. See variable interpolation ⟨https://github.com/compose-spec/compose-spec/blob/master/spec.md#interpolation⟩.

If you change a service's **Dockerfile** or the contents of its build directory, run **docker compose build** to rebuild it.

## OPTIONS

**--build-arg**=\[\]\
 	Set build-time variables for services

**--builder**=""\
 	Set builder to use

**-h**, **--help**\[=false\]\
 	help for build

**-m**, **--memory**=0\
 	Set memory limit for the build container. Not supported by BuildKit.

**--no-cache**\[=false\]\
 	Do not use cache when building the image

**--pull**\[=false\]\
 	Always attempt to pull a newer version of the image

**--push**\[=false\]\
 	Push service images

**-q**, **--quiet**\[=false\]\
 	Don't print anything to STDOUT

**--ssh**=""\
 	Set SSH authentications used when building service images. (use 'default' for using your default SSH Agent)

**--with-dependencies**\[=false\]\
 	Also build dependencies (transitively)

## OPTIONS INHERITED FROM PARENT COMMANDS

**--dry-run**\[=false\]\
 	Execute command in dry run mode

## SEE ALSO

**[docker-compose(1)](/docker-compose/1.md)**