Skip to content

Commit

Permalink
Add troubleshooting advice about the --userns option.
Browse files Browse the repository at this point in the history
While I'm at it, add a link to the troubleshooting guide into
the issue template.
  • Loading branch information
jberkus committed Mar 19, 2021
1 parent 5325957 commit 4ebb625
Show file tree
Hide file tree
Showing 2 changed files with 11 additions and 2 deletions.
3 changes: 2 additions & 1 deletion .github/ISSUE_TEMPLATE.md
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,8 @@ Briefly describe the problem you are having in a few paragraphs.
(paste your output here)
```

**Have you tested with the latest version of Podman and have you checked the Podman Troubleshooting Guide?**
**Have you tested with the latest version of Podman and have you checked the Podman Troubleshooting Guide? (https://github.com/containers/podman/blob/master/troubleshooting.md)**


Yes/No

Expand Down
10 changes: 9 additions & 1 deletion troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ touch: cannot touch '/content/file': Permission denied

#### Solution

This is usually caused by SELinux.
This is sometimes caused by SELinux, and sometimes by user namespaces.

Labeling systems like SELinux require that proper labels are placed on volume
content mounted into a container. Without a label, the security system might
Expand All @@ -47,6 +47,14 @@ will disable SELinux separation for the container.

$ podman run --security-opt label=disable -v ~:/home/user fedora touch /home/user/file

In cases where the container image runs as a specific, non-root user, though, the
solution is to fix the user namepsace. This would include container images such as
the Jupyter Notebook image (which runs as "jovyan") and the Postgres image (which runs
as "postgres"). In either case, use the `--userns` switch to map user namespaces,
most of the time by using keep_id option.

$ podman run -v "$PWD":/home/jovyan/work --userns=keep_id jupyter/scipy-notebook

---
### 3) No such image or Bare keys cannot contain ':'

Expand Down

0 comments on commit 4ebb625

Please sign in to comment.