summaryrefslogtreecommitdiff
path: root/troubleshooting.md
diff options
context:
space:
mode:
authorErik Sjölund <erik.sjolund@gmail.com>2022-02-18 06:59:27 +0100
committerErik Sjölund <erik.sjolund@gmail.com>2022-02-18 07:01:32 +0100
commit8c9d37fafcee70ef6b03c5301fc1afe94e5dec4f (patch)
treeea3431d82dd8c136717dcd1ac7cc003a0b83402b /troubleshooting.md
parenta88ea2c68b1ef01077a53b1c568b85667dcbc1e2 (diff)
downloadpodman-8c9d37fafcee70ef6b03c5301fc1afe94e5dec4f.tar.gz
podman-8c9d37fafcee70ef6b03c5301fc1afe94e5dec4f.tar.bz2
podman-8c9d37fafcee70ef6b03c5301fc1afe94e5dec4f.zip
[CI:DOCS] troubleshooting: mention machinectl and systemd-run
Signed-off-by: Erik Sjölund <erik.sjolund@gmail.com>
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 6f2a96a56..9e566d870 100644
--- a/troubleshooting.md
+++ b/troubleshooting.md
@@ -903,10 +903,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