summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--README.md2
-rw-r--r--rootless.md41
2 files changed, 43 insertions, 0 deletions
diff --git a/README.md b/README.md
index c1fd6fad9..742c6238c 100644
--- a/README.md
+++ b/README.md
@@ -29,6 +29,8 @@ This project tests all builds against each supported version of Fedora, the late
1. Further work on the podman pod command
1. Further improvements on rootless containers
+## [Shortcomings of Rootless Podman](https://github.com/containers/libpod/blob/master/docs/rootless.md)
+
## Out of scope
* Specializing in signing and pushing images to various storage backends.
diff --git a/rootless.md b/rootless.md
new file mode 100644
index 000000000..d397ae857
--- /dev/null
+++ b/rootless.md
@@ -0,0 +1,41 @@
+# Shortcomings of Rootless Podman
+
+The following list categorizes the known issues and irregularities with running Podman as a non-root user. Although currently functional, there is still a number of work items that are under consideration to be added. These proposed changes are in varying degrees of design and development.
+
+Contributors are more than welcomed to help with this work. If you decide to carve off a piece and work on it, please create an issue in [GitHub](https://github.com/containers/libpod/issues), and assign it to yourself. If you find other unexpected behaviour with rootless Podman and feel it’s warranted, please feel free to update this document.
+
+* Podman can not create containers that bind to ports < 1024.
+ * The kernel does not allow processes without CAP_NET_BIND_SERVICE to bind to low ports.
+* Lacking “How To” documentation or documentation in general
+* If /etc/subuid and /etc/subgid not setup for a user, then podman commands
+can easily fail
+ * This can be a big issue on machines using Network Based Password information (FreeIPA, Active Directory, LDAP)
+ * We are working to get support for NSSWITCH on the /etc/subuid and /etc/subgid files.
+* No cgroup Support (hopefully fixed when cgroups V2 happens).
+ * Cgroups V1 does not safely support cgroup delegation.
+ * Cgroups V2 development for container support is ongoing.
+* Can not share container images with CRI-O or other users
+* Difficult to use additional stores for sharing content
+* Does not work on NFS homedirs
+ * NFS enforces file creation on different UIDs on the server side and does not understand User Namespace.
+ * When a container root process like YUM attempts to create a file owned by a different UID, NFS Server denies the creation.
+* Does not work with homedirs mounted with noexec/nodev
+ * User can setup storage to point to other directories they can write to that are not mounted noexec/nodev
+* Can not use overlayfs driver, but does support fuse-overlayfs
+ * Ubuntu supports non root overlay, but no other Linux distros do.
+* Only other supported driver is VFS.
+* No KATA Container support
+* No CNI Support
+ * CNI wants to modify IPTables, plus other network manipulation that I requires CAP_SYS_ADMIN.
+ * There is potential we could probably do some sort of blacklisting of the relevant plugins, and add a new plugin for rootless networking - slirp4netns as one example and there may be others
+* Cannot use ping
+ * [(Can be fixed by setting sysctl on host)](https://github.com/containers/libpod/blob/master/troubleshooting.md#5-rootless-containers-cannot-ping-hosts)
+* Requires new shadow-utils (not found in older (RHEL7/Centos7 distros) Should be fixed in RHEL7.7 release
+* A few commands do not work.
+ * mount/unmount (on fuse-overlay)
+ * Only works if you enter the mount namespace with a tool like buildah unshare
+ * podman stats (Lack of Cgroup support)
+ * Checkpoint and Restore (CRIU requires root)
+ * Pause and Unpause (no freezer cgroup)
+* Issues with higher UIDs can cause builds to fail
+ * If a build is attempting to use a UID that is not mapped into the user namespace mapping for a container, then builds will not be able to put the UID in an image.