From a3ae93dc2efa2520940c1e8a1771b6e157bfc219 Mon Sep 17 00:00:00 2001 From: Kai Blin Date: Tue, 18 Aug 2015 08:56:56 +0200 Subject: [PATCH] reference/run: Some editorial changes Based on the suggestions from @moxiegirl, some changes to make the wording more clear. Signed-off-by: Kai Blin (cherry picked from commit ba29d31c9cb205863d8d63542ef969e7c6fafcfe) Conflicts: docs/reference/run.md --- docs/reference/run.md | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/docs/reference/run.md b/docs/reference/run.md index 51e27e5e6..2cfb88b1e 100644 --- a/docs/reference/run.md +++ b/docs/reference/run.md @@ -1142,14 +1142,17 @@ volume mounted on the host). ### USER -The default user within a container is `root` (id = 0), but if the -developer created additional users, those are accessible too. The -developer can set a default user to run the first process with the -Dockerfile `USER` instruction, but the operator can override it: +`root` (id = 0) is the default user within a container. The image developer can +create additional users. Those users are accessible by name. When passing a numeric +ID, the user does not have to exist in the container. + +The developer can set a default user to run the first process with the +Dockerfile `USER` instruction. When starting a container, the operator can override +the `USER` instruction by passing the `-u` option. -u="": Username or UID -> **Note:** if you pass numeric uid, it must be in range 0-2147483647. +> **Note:** if you pass a numeric uid, it must be in the range of 0-2147483647. ### WORKDIR