docker compose build
Build or rebuild services
Usage
$ docker compose build [OPTIONS] [SERVICE...]
Refer to the options section for an overview of available OPTIONS
for this command.
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.
Options
Name, shorthand | Default | Description |
--build-arg |
Set build-time variables for services. | |
--no-cache |
Do not use cache when building the image | |
--progress |
auto |
Set type of progress output (auto, tty, plain, quiet) |
--pull |
Always attempt to pull a newer version of the image. | |
--push |
Push service images. | |
--quiet , -q |
Don’t print anything to STDOUT | |
--ssh |
Set SSH authentications used when building service images. (use ‘default’ for using your default SSH Agent) |
Parent command
Command | Description |
---|---|
docker compose | Docker Compose |
Related commands
Command | Description |
docker compose build | Build or rebuild services |
docker compose config | Parse, resolve and render compose file in 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 service 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 |
docker compose version | Show the Docker Compose version information |