Docs: document remote URL support for --file flag in buildx build #3451
+27
−3
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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>
AkhilManoj03
force-pushed
the
3121-improve-file-flag-docs
branch
from
7e9b39c to
967471d
Compare
dvdksn
suggested changes
Dec 15, 2025
Contributor
dvdksn
left a comment
dvdksn
left a comment
There was a problem hiding this comment.
Good catch 🙇 needs some small changes
| $ docker buildx build -f path/to/Dockerfile . | ||
| ``` | ||
|
|
||
| #### remote URL |
Contributor
There was a problem hiding this comment.
Suggested change
| #### remote URL | |
| #### Remote URL |
| - [`remote URL`](#remote-url) | ||
| - [`stdin`](#stdin) | ||
|
|
||
| #### local file path |
Contributor
There was a problem hiding this comment.
Suggested change
| #### local file path | |
| #### Local file path |
|
|
||
| #### stdin | ||
|
|
||
| To read a Dockerfile from stdin, you can use `-` as the argument: |
Contributor
There was a problem hiding this comment.
Suggested change
| To read a Dockerfile from stdin, you can use `-` as the argument: | |
| To read a Dockerfile from stdin, use `-` as the argument: |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Addresses documentation gap from #3121 (comment).
The
--fileflag indocker buildx buildsupports URLs in addition to local paths and stdin, but this wasn't documented. Updated documentation to reflect this with examples for each use case.