Merge pull request #3451 from AkhilManoj03/3121-improve-file-flag-docs

Docs: document remote URL support for --file flag in buildx build
This commit is contained in:
Tõnis Tiigi
2026-02-24 07:52:20 -08:00
committed by GitHub
+27 -3
View File
@@ -553,13 +553,37 @@ the daemon runs the containers used in the build with the
### <a name="file"></a> Specify a Dockerfile (-f, --file)
```console
$ docker buildx build -f <filepath> .
$ 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 - .