Merge pull request docker#2091 from mikesir87/user-group-info

Add clarification when using USER UID:GID
dperny · Jan 16, 2020 · c6d10b6 · c6d10b6
2 parents d05846d + b3a1681
commit c6d10b6
Showing 1 changed file with 3 additions and 0 deletions.
diff --git a/docs/reference/builder.md b/docs/reference/builder.md
@@ -1484,6 +1484,9 @@ The `USER` instruction sets the user name (or UID) and optionally the user
 group (or GID) to use when running the image and for any `RUN`, `CMD` and
 `ENTRYPOINT` instructions that follow it in the `Dockerfile`.
 
+> Note that when specifying a group for the user, the user will have _only_ the
+> specified group membership. Any other configured group memberships will be ignored.
+
 > **Warning**:
 > When the user doesn't have a primary group then the image (or the next
 > instructions) will be run with the `root` group.