docker compose build


Build or rebuild services


$ docker compose build [SERVICE...]

Extended description

Services are built once and then tagged, by default as project_service.

If the Compose file specifies an image name, the image is tagged with that name, substituting any variables beforehand. See variable interpolation.

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


Name, shorthand Default Description
--build-arg Set build-time variables for services.
--compress true Compress the build context using gzip. DEPRECATED
--force-rm true Always remove intermediate containers. DEPRECATED
--memory , -m Set memory limit for the build container. Not supported on buildkit yet.
--no-cache Do not use cache when building the image
--no-rm Do not remove intermediate containers after a successful build. DEPRECATED
--parallel true Build images in parallel. DEPRECATED
--progress auto Set type of progress output ("auto", "plain", "noTty")
--pull Always attempt to pull a newer version of the image.
--quiet , -q Don't print anything to STDOUT

Parent command

Command Description
docker compose Docker Compose
Command Description
docker compose build Build or rebuild services
docker compose convert Converts the compose file to platform’s canonical format
docker compose cp Copy files/folders between a service container and the local filesystem
docker compose create Creates containers for a service.
docker compose down Stop and remove containers, networks
docker compose events Receive real time events from containers.
docker compose exec Execute a command in a running container.
docker compose images List images used by the created containers
docker compose kill Force stop service containers.
docker compose logs View output from containers
docker compose ls List running compose projects
docker compose pause pause services
docker compose port Print the public port for a port binding.
docker compose ps List containers
docker compose pull Pull service images
docker compose push Push service images
docker compose restart Restart containers
docker compose rm Removes stopped service containers
docker compose run Run a one-off command on a service.
docker compose start Start services
docker compose stop Stop services
docker compose top Display the running processes
docker compose unpause unpause services
docker compose up Create and start containers