summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorDaniel J Walsh <dwalsh@redhat.com>2018-07-30 09:44:02 -0400
committerAtomic Bot <atomic-devel@projectatomic.io>2018-07-31 08:35:20 +0000
commit00caebde61256dc7baaf99e5052305a1e15cbee5 (patch)
tree9a299521f91286d059106253de034b3fe5edba2d /docs
parent5a4e5902a00fe593afc560e8ef9af1b246821f62 (diff)
downloadpodman-00caebde61256dc7baaf99e5052305a1e15cbee5.tar.gz
podman-00caebde61256dc7baaf99e5052305a1e15cbee5.tar.bz2
podman-00caebde61256dc7baaf99e5052305a1e15cbee5.zip
Add documentations on how to setup /etc/subuid and /etc/subgid
Signed-off-by: Daniel J Walsh <dwalsh@redhat.com> Closes: #1185 Approved by: giuseppe
Diffstat (limited to 'docs')
-rw-r--r--docs/podman.1.md11
1 files changed, 11 insertions, 0 deletions
diff --git a/docs/podman.1.md b/docs/podman.1.md
index 1ca420d12..b5331a45d 100644
--- a/docs/podman.1.md
+++ b/docs/podman.1.md
@@ -171,6 +171,17 @@ Containers created by a non-root user are not visible to other users and are not
It is required to have multiple uids/gids set for an user. Be sure the user is present in the files `/etc/subuid` and `/etc/subgid`.
+If you have a recent version of usermod, you can execute the following
+commands to add the ranges to the files
+
+ $ sudo usermod --add-subuids 10000-75535 USERNAME
+ $ sudo usermod --add-subgids 10000-75535 USERNAME
+
+Or just add the content manually.
+
+ $ echo USERNAME:10000:65536 >> /etc/subuid
+ $ echo USERNAME:10000:65536 >> /etc/subgid
+
Images are pulled under `XDG_DATA_HOME` when specified, otherwise in the home directory of the user under `.local/share/containers/storage`.
Currently it is not possible to create a network device, so rootless containers need to run in the host network namespace. If a rootless container creates a network namespace,