diff --git a/docs/reference/buildx_build.md b/docs/reference/buildx_build.md index 4d85a6a47..d7443e3ab 100644 --- a/docs/reference/buildx_build.md +++ b/docs/reference/buildx_build.md @@ -553,13 +553,37 @@ the daemon runs the containers used in the build with the ### Specify a Dockerfile (-f, --file) ```console -$ docker buildx build -f . +$ docker buildx build -f [PATH|URL|-] . ``` -Specifies the filepath of the Dockerfile to use. +Specifies the location of the Dockerfile to use. If unspecified, a file named `Dockerfile` at the root of the build context is used by default. -To read a Dockerfile from stdin, you can use `-` as the argument for `--file`. +The supported inputs formats are: + +- [`Local file path`](#local-file-path) +- [`Remote URL`](#remote-url) +- [`Standard input`](#standard-input) + +#### Local file path + +To specify a path to a local Dockerfile: + +```console +$ docker buildx build -f path/to/Dockerfile . +``` + +#### Remote URL + +To specify a URL to a remote Dockerfile: + +```console +$ docker buildx build -f https://raw.githubusercontent.com/docker/buildx/refs/tags/v0.29.0/Dockerfile . +``` + +#### Standard input + +To read a Dockerfile from stdin, use `-` as the argument: ```console $ cat Dockerfile | docker buildx build -f - .