reference/run: Clarify the use of numeric UIDs
| ... | ... |
@@ -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 |
|