summaryrefslogtreecommitdiff
path: root/troubleshooting.md
diff options
context:
space:
mode:
authorOpenShift Merge Robot <openshift-merge-robot@users.noreply.github.com>2022-02-23 10:29:12 -0500
committerGitHub <noreply@github.com>2022-02-23 10:29:12 -0500
commitd3699bbce63f283a609053d4aca23e4abe7dae4d (patch)
tree0d6106f81de87ced7d0c29e8bfab722af2ab9973 /troubleshooting.md
parenta234e4e19662e172472877ce69523f4afea5c12e (diff)
parent8c9d37fafcee70ef6b03c5301fc1afe94e5dec4f (diff)
downloadpodman-d3699bbce63f283a609053d4aca23e4abe7dae4d.tar.gz
podman-d3699bbce63f283a609053d4aca23e4abe7dae4d.tar.bz2
podman-d3699bbce63f283a609053d4aca23e4abe7dae4d.zip
Merge pull request #13231 from eriksjolund/troubleshooting_mention_systemd-run_and_machinectl
[CI:DOCS] troubleshooting: mention machinectl and systemd-run
Diffstat (limited to 'troubleshooting.md')
-rw-r--r--troubleshooting.md19
1 files changed, 17 insertions, 2 deletions
diff --git a/troubleshooting.md b/troubleshooting.md
index dedcf6bb9..8bce8e50f 100644
--- a/troubleshooting.md
+++ b/troubleshooting.md
@@ -914,10 +914,25 @@ Error: error creating tmpdir: mkdir /run/user/1000: permission denied
Podman expects a valid login session for the `rootless+cgroupv2` use-case. Podman execution is expected to fail if the login session is not present. In most cases, podman will figure out a solution on its own but if `XDG_RUNTIME_DIR` is pointing to a path that is not writable execution will most fail. Typical scenarious of such cases are seen when users are trying to use Podman with `su - <user> -c '<podman-command>`, or `sudo -l` and badly configured systemd session.
-Resolution steps
+Alternatives:
+
+* Execute Podman via __systemd-run__ that will first start a systemd login session:
+
+ ```
+ sudo systemd-run --machine=username@ --quiet --user --collect --pipe --wait podman run --rm docker.io/library/alpine echo hello
+ ```
+* Start an interactive shell in a systemd login session with the command `machinectl shell <username>@`
+ and then run Podman
+
+ ```
+ $ sudo -i
+ # machinectl shell username@
+ Connected to the local host. Press ^] three times within 1s to exit session.
+ $ podman run --rm docker.io/library/alpine echo hello
+ ```
+* Start a new systemd login session by logging in with `ssh` i.e. `ssh <username>@localhost` and then run Podman.
* Before invoking Podman command create a valid login session for your rootless user using `loginctl enable-linger <username>`
-* If `loginctl` is unavailable you can also try logging in via `ssh` i.e `ssh <username>@localhost`.
### 31) 127.0.0.1:7777 port already bound