spiegel_podman/docs/source
Satwik Sai Prakash Sahoo 02f0ee0de0
docs: document keep-groups limitation with systemd services
When --group-add keep-groups (or GroupAdd=keep-groups in Quadlet) is
used, supplementary groups are inherited from the calling process. When
Podman is launched via a systemd user service, the calling process is
the systemd --user manager, which only has the groups assigned to the
user at the time the manager was started.

If the user was added to new groups after the systemd user session
started (e.g. via usermod), those groups will not be visible to the
container. This is expected Linux process credential behavior, but was
undocumented, causing confusion for Quadlet users.

Add notes to both option and Quadlet docs explaining this behavior and
the workaround (restarting the user's systemd manager).

Fixes: #27876
Signed-off-by: Satwik Sai Prakash Sahoo <sahoospsatwik@gmail.com>
2026-08-04 01:35:18 +05:30
..
_static build the swagger.yml on readthedocs 2026-06-23 19:10:34 +02:00
locale/ja/LC_MESSAGES [DOCS] Update references common -> container-libs/common 2026-02-04 21:29:17 +10:00
markdown docs: document keep-groups limitation with systemd services 2026-08-04 01:35:18 +05:30
Commands.rst Initial implementation of podman quadlet commands 2025-07-18 13:57:11 -07:00
conf.py Revert "docs: generate Reference version list from json file" 2026-06-23 19:09:30 +02:00
includes.rst add containerfile doc link 2025-09-19 17:18:45 -04:00
index.rst [CI:DOCS] Add link to podman py docs 2023-11-17 07:18:59 -05:00
Introduction.rst add containerfile doc link 2025-09-19 17:18:45 -04:00
Reference.rst build the swagger.yml on readthedocs 2026-06-23 19:10:34 +02:00
Search.rst [CI:DOCS] Docs revamp. 2020-05-21 17:16:10 -04:00
Tutorials.rst fix typo in Tutorials.rst 2024-05-23 16:15:40 +01:00