summaryrefslogtreecommitdiff
path: root/troubleshooting.md
diff options
context:
space:
mode:
authorTomSweeneyRedHat <tsweeney@redhat.com>2020-05-04 19:32:33 -0400
committerTomSweeneyRedHat <tsweeney@redhat.com>2020-05-04 19:36:24 -0400
commitfa3986125e99c8d2fe4458cd1d5773964b14521f (patch)
tree589b880f01b28eb1925307eb6564b12f14e15bd8 /troubleshooting.md
parent01aad516e012fe46179e053addd7a8a84788228b (diff)
downloadpodman-fa3986125e99c8d2fe4458cd1d5773964b14521f.tar.gz
podman-fa3986125e99c8d2fe4458cd1d5773964b14521f.tar.bz2
podman-fa3986125e99c8d2fe4458cd1d5773964b14521f.zip
[CI:DOC] Add linger to troubleshooting
Adding a troubleshooting note about how to configure systemd to linger for detached containers in rootless mode. This came up in an email stream on the Podman mailing list today and answered by @mheon Signed-off-by: TomSweeneyRedHat <tsweeney@redhat.com>
Diffstat (limited to 'troubleshooting.md')
-rw-r--r--troubleshooting.md20
1 files changed, 20 insertions, 0 deletions
diff --git a/troubleshooting.md b/troubleshooting.md
index ea85df58a..14d1a867e 100644
--- a/troubleshooting.md
+++ b/troubleshooting.md
@@ -517,3 +517,23 @@ The runtime uses `setgroups(2)` hence the process looses all additional groups
the non-root user has. If you use the `crun` runtime, 0.10.4 or newer,
then you can enable a workaround by adding `--annotation io.crun.keep_original_groups=1`
to the `podman` command line.
+
+### 22) A rootless container running in detached mode is closed at logout
+
+When running a container with a command like `podman run --detach httpd` as
+a rootless user, the container is closed upon logout and is not kept running.
+
+#### Symptom
+
+When logging out of a rootless user session, all containers that were started
+in detached mode are stopped and are not kept running. As the root user, these
+same containers would survive the logout and continue running.
+
+#### Solution
+
+When systemd notes that a session that started a Podman container has exited,
+it will also stop any containers that has been associated with it. To avoid
+this, use the following command before logging out: `loginctl enable-linger`.
+To later revert the linger functionality, use `loginctl disable-linger`.
+
+LOGINCTL(1), SYSTEMD(1)