Browse code

Merge pull request #15510 from kblin/issue-14795

reference/run: Clarify the use of numeric UIDs

moxiegirl authored on 2015/08/19 01:43:16
Showing 1 changed files
... ...
@@ -1142,14 +1142,17 @@ volume mounted on the host).
1142 1142
 
1143 1143
 ### USER
1144 1144
 
1145
-The default user within a container is `root` (id = 0), but if the
1146
-developer created additional users, those are accessible too. The
1147
-developer can set a default user to run the first process with the
1148
-Dockerfile `USER` instruction, but the operator can override it:
1145
+`root` (id = 0) is the default user within a container. The image developer can
1146
+create additional users. Those users are accessible by name.  When passing a numeric
1147
+ID, the user does not have to exist in the container.
1148
+
1149
+The developer can set a default user to run the first process with the
1150
+Dockerfile `USER` instruction. When starting a container, the operator can override
1151
+the `USER` instruction by passing the `-u` option.
1149 1152
 
1150 1153
     -u="": Username or UID
1151 1154
 
1152
-> **Note:** if you pass numeric uid, it must be in range 0-2147483647.
1155
+> **Note:** if you pass a numeric uid, it must be in the range of 0-2147483647.
1153 1156
 
1154 1157
 ### WORKDIR
1155 1158