| # builder build |
| |
| <!---MARKER_GEN_START--> |
| Build an image from a Dockerfile |
| |
| ### Aliases |
| |
| `docker image build`, `docker build`, `docker builder build` |
| |
| ### Options |
| |
| | Name | Type | Default | Description | |
| |:-----------------------------------------------------------------------------------------------------------------------------------------------------|:--------------|:----------|:------------------------------------------------------------------| |
| | [`--add-host`](https://docs.docker.com/reference/cli/docker/buildx/build/#add-host) | `list` | | Add a custom host-to-IP mapping (`host:ip`) | |
| | [`--build-arg`](https://docs.docker.com/reference/cli/docker/buildx/build/#build-arg) | `list` | | Set build-time variables | |
| | `--cache-from` | `stringSlice` | | Images to consider as cache sources | |
| | [`--cgroup-parent`](https://docs.docker.com/reference/cli/docker/buildx/build/#cgroup-parent) | `string` | | Set the parent cgroup for the `RUN` instructions during build | |
| | `--compress` | `bool` | | Compress the build context using gzip | |
| | `--cpu-period` | `int64` | `0` | Limit the CPU CFS (Completely Fair Scheduler) period | |
| | `--cpu-quota` | `int64` | `0` | Limit the CPU CFS (Completely Fair Scheduler) quota | |
| | `-c`, `--cpu-shares` | `int64` | `0` | CPU shares (relative weight) | |
| | `--cpuset-cpus` | `string` | | CPUs in which to allow execution (0-3, 0,1) | |
| | `--cpuset-mems` | `string` | | MEMs in which to allow execution (0-3, 0,1) | |
| | `--disable-content-trust` | `bool` | `true` | Skip image verification | |
| | [`-f`](https://docs.docker.com/reference/cli/docker/buildx/build/#file), [`--file`](https://docs.docker.com/reference/cli/docker/buildx/build/#file) | `string` | | Name of the Dockerfile (Default is `PATH/Dockerfile`) | |
| | `--force-rm` | `bool` | | Always remove intermediate containers | |
| | `--iidfile` | `string` | | Write the image ID to the file | |
| | `--isolation` | `string` | | Container isolation technology | |
| | `--label` | `list` | | Set metadata for an image | |
| | `-m`, `--memory` | `bytes` | `0` | Memory limit | |
| | `--memory-swap` | `bytes` | `0` | Swap limit equal to memory plus swap: -1 to enable unlimited swap | |
| | [`--network`](https://docs.docker.com/reference/cli/docker/buildx/build/#network) | `string` | `default` | Set the networking mode for the RUN instructions during build | |
| | `--no-cache` | `bool` | | Do not use cache when building the image | |
| | `--platform` | `string` | | Set platform if server is multi-platform capable | |
| | `--pull` | `bool` | | Always attempt to pull a newer version of the image | |
| | `-q`, `--quiet` | `bool` | | Suppress the build output and print image ID on success | |
| | `--rm` | `bool` | `true` | Remove intermediate containers after a successful build | |
| | `--security-opt` | `stringSlice` | | Security options | |
| | `--shm-size` | `bytes` | `0` | Size of `/dev/shm` | |
| | `--squash` | `bool` | | Squash newly built layers into a single new layer | |
| | [`-t`](https://docs.docker.com/reference/cli/docker/buildx/build/#tag), [`--tag`](https://docs.docker.com/reference/cli/docker/buildx/build/#tag) | `list` | | Name and optionally a tag in the `name:tag` format | |
| | [`--target`](https://docs.docker.com/reference/cli/docker/buildx/build/#target) | `string` | | Set the target build stage to build. | |
| | `--ulimit` | `ulimit` | | Ulimit options | |
| |
| |
| <!---MARKER_GEN_END--> |
| |
| ## Description |
| |
| See [docker build](image_build.md) for more information. |
