docs: rewrite COPY --chown/--chmod, add non-octal --chmod (labs) #6430
+55
−41
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
dvdksn
commented
Dec 19, 2025
| not translate between Linux and Windows, the use of `/etc/passwd` and `/etc/group` for | ||
| translating user and group names to IDs restricts this feature to only be viable for | ||
| Linux OS-based containers. | ||
| The `--chmod` flag is not supported when building Windows containers. |
Collaborator
Author
There was a problem hiding this comment.
idk if this is worth mentioning still, it was probably a leftover from when this doc described the legacy builder. But I guess it doesn't hurt; still applies in the (experimental) wcow case.
tonistiigi
reviewed
Dec 19, 2025
| ``` | ||
|
|
||
| The `--chmod` flag supports octal notation (e.g., `755`, `644`). | ||
| Symbolic notation (e.g., `+x`, `g=u`) requires the `docker/dockerfile:1-labs` |
| The `--chmod` flag supports octal notation (e.g., `755`, `644`). | ||
| Symbolic notation (e.g., `+x`, `g=u`) requires the `docker/dockerfile:1-labs` | ||
| syntax directive. This is useful when octal isn't flexible enough. For example, | ||
| `u=rwX,go=rX` sets directories to 755 and files to 644, while preserving the |
Member
There was a problem hiding this comment.
Maybe link to man chmod like https://man.freebsd.org/cgi/man.cgi?chmod for a longer explanation.
dvdksn
force-pushed
the
chmod-nonoctal-docs
branch
from
2ba142c to
fc93370
Compare
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
dvdksn
force-pushed
the
chmod-nonoctal-docs
branch
from
fc93370 to
0af0054
Compare
tonistiigi
approved these changes
Jan 10, 2026
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.
docs follow-up to: