# docker compose build

<!---MARKER_GEN_START-->
Build or rebuild services

### Options

| Name             | Type          | Default | Description                                                                                                 |
|:-----------------|:--------------|:--------|:------------------------------------------------------------------------------------------------------------|
| `--build-arg`    | `stringArray` |         | Set build-time variables for services.                                                                      |
| `--builder`      | `string`      |         | Set builder to use.                                                                                         |
| `--dry-run`      |               |         | Execute command in dry run mode                                                                             |
| `-m`, `--memory` | `bytes`       | `0`     | Set memory limit for the build container. Not supported by BuildKit.                                        |
| `--no-cache`     |               |         | Do not use cache when building the image                                                                    |
| `--pull`         |               |         | Always attempt to pull a newer version of the image.                                                        |
| `--push`         |               |         | Push service images.                                                                                        |
| `-q`, `--quiet`  |               |         | Don't print anything to STDOUT                                                                              |
| `--ssh`          | `string`      |         | Set SSH authentications used when building service images. (use 'default' for using your default SSH Agent) |


<!---MARKER_GEN_END-->

## 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.