Skip to content

Docs: document remote URL support for --file flag in buildx build#3451

Merged
tonistiigi merged 1 commit intodocker:masterfrom
AkhilManoj03:3121-improve-file-flag-docs
Feb 24, 2026
Merged

Docs: document remote URL support for --file flag in buildx build#3451
tonistiigi merged 1 commit intodocker:masterfrom
AkhilManoj03:3121-improve-file-flag-docs

Conversation

@AkhilManoj03
Copy link
Contributor

Addresses documentation gap from #3121 (comment).

The --file flag in docker buildx build supports URLs in addition to local paths and stdin, but this wasn't documented. Updated documentation to reflect this with examples for each use case.

Copy link
Contributor

@dvdksn dvdksn left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good catch 🙇 needs some small changes

$ docker buildx build -f path/to/Dockerfile .
```

#### remote URL
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
#### remote URL
#### Remote URL

- [`remote URL`](#remote-url)
- [`stdin`](#stdin)

#### local file path
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
#### local file path
#### Local file path


#### stdin

To read a Dockerfile from stdin, you can use `-` as the argument:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
To read a Dockerfile from stdin, you can use `-` as the argument:
To read a Dockerfile from stdin, use `-` as the argument:

Expand the buildx build doc to include details on the supported input
options for the --file flag: local file path, remote URL, and stdin. Add
examples for each input type to enhance user understanding.

Signed-off-by: Akhil Manoj <akhil.manoj2003@gmail.com>
Signed-off-by: Akhil Manoj <manoja2@vcu.edu>
@crazy-max crazy-max force-pushed the 3121-improve-file-flag-docs branch from 967471d to 1f69c57 Compare February 23, 2026 10:35
Copy link
Member

@crazy-max crazy-max left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Rebased and applied requested changes

@crazy-max crazy-max requested a review from dvdksn February 23, 2026 10:36
@crazy-max crazy-max added this to the v0.32.0 milestone Feb 23, 2026
@tonistiigi tonistiigi merged commit 9607bba into docker:master Feb 24, 2026
40 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants