compose/docs/reference/build.md

<!--[metadata]>
+++
title = "build"
description = "build"
keywords = ["fig, composition, compose, docker, orchestration, cli,  build"]
[menu.main]
identifier="build.compose"
parent = "smn_compose_cli"
+++
<![end-metadata]-->

# build

```
Usage: build [options] [SERVICE...]

Options:
--force-rm  Always remove intermediate containers.
--no-cache  Do not use cache when building the image.
--pull      Always attempt to pull a newer version of the image.
```

Services are built once and then tagged as `project_service`, e.g.,
`composetest_db`. If you change a service's Dockerfile or the contents of its
build directory, run `docker-compose build` to rebuild it.
Updating Compose documentation - Split out commands into individual pages for maintainability - Add full usage in commands pages for usability - Updated description of the run command - adding in Aanand's comment Signed-off-by: Mary Anthony <mary@docker.com> 2015-07-17 02:30:49 +02:00			`<!--[metadata]>`
			`+++`
			`title = "build"`
			`description = "build"`
			`keywords = ["fig, composition, compose, docker, orchestration, cli, build"]`
			`[menu.main]`
Updating build so that contributors can build public docs Changed base image Signed-off-by: Mary Anthony <mary@docker.com> 2015-07-19 23:39:25 +02:00			`identifier="build.compose"`
Updating Compose documentation - Split out commands into individual pages for maintainability - Add full usage in commands pages for usability - Updated description of the run command - adding in Aanand's comment Signed-off-by: Mary Anthony <mary@docker.com> 2015-07-17 02:30:49 +02:00			`parent = "smn_compose_cli"`
			`+++`
			`<![end-metadata]-->`

			`# build`

			```
			`Usage: build [options] [SERVICE...]`

			`Options:`
Added --force-rm to compose build. It's a flag passed to docker build that removes the intermediate containers left behind on fail builds. Signed-off-by: Adrian Budau <budau.adi@gmail.com> 2015-10-27 10:00:51 +01:00			`--force-rm Always remove intermediate containers.`
Updating Compose documentation - Split out commands into individual pages for maintainability - Add full usage in commands pages for usability - Updated description of the run command - adding in Aanand's comment Signed-off-by: Mary Anthony <mary@docker.com> 2015-07-17 02:30:49 +02:00			`--no-cache Do not use cache when building the image.`
Add new --pull option in build. Signed-off-by: Christophe Labouisse <christophe@labouisse.org> 2015-09-14 15:02:15 +02:00			`--pull Always attempt to pull a newer version of the image.`
Updating Compose documentation - Split out commands into individual pages for maintainability - Add full usage in commands pages for usability - Updated description of the run command - adding in Aanand's comment Signed-off-by: Mary Anthony <mary@docker.com> 2015-07-17 02:30:49 +02:00			```

			Services are built once and then tagged as `project_service`, e.g.,
			`composetest_db`. If you change a service's Dockerfile or the contents of its
Run pre-commit on all files Signed-off-by: Daniel Nephin <dnephin@gmail.com> 2015-08-24 21:25:25 +02:00			build directory, run `docker-compose build` to rebuild it.