Fix tutorial for rootless mode

Users have gotten confused when attempting the introduction turturial in rootless mode. Explain that they have to `buildah unshare` before mounting the image. Fixes: #2833 Signed-off-by: Daniel J Walsh <[email protected]>
containers · Feb 10, 2021 · 7775e0f · 7775e0f
1 parent 0508fba
commit 7775e0f
Showing 1 changed file with 5 additions and 0 deletions.
diff --git a/docs/tutorials/01-intro.md b/docs/tutorials/01-intro.md
@@ -100,6 +100,11 @@ Nope. This really is empty. The package installer `dnf` is not even inside this
 
     # scratchmnt=$(buildah mount $newcontainer)
 
+Note: If attempting to mount in rootless mode, the command fails. Mounting an image needs to be done in a different mount namespace. Enter the mount namespace by executing the `buildah unshare` command. See buildah-mount(1) man page for more information.
+
+    $ buildah unshare
+    # scratchmnt=$(buildah mount $newcontainer)
+
 By echoing `$scratchmnt` we can see the path for the [overlay image](https://wiki.archlinux.org/index.php/Overlay_filesystem), which gives you a link directly to the root file system of the container.
 
     # echo $scratchmnt