Skip to content

Add docs for running rootless Podman as a non-root user#50

Open
poupryc wants to merge 1 commit into
linuxserver:mainfrom
poupryc:main
Open

Add docs for running rootless Podman as a non-root user#50
poupryc wants to merge 1 commit into
linuxserver:mainfrom
poupryc:main

Conversation

@poupryc

@poupryc poupryc commented Jul 5, 2026

Copy link
Copy Markdown
Contributor

linuxserver.io


  • I have read the contributing guideline and understand that I have made the correct modifications

Description:

Document how to run the socket proxy as an unprivileged user (nobody, UID/GID 65534) under rootless Podman, in addition to the existing "docker user in a rootless environment" case where the container process still runs as root inside its namespace.

Covers the two requirements needed for this to work: mapping the host user onto the in-container user via --userns=keep-id so the mounted Podman socket is readable. Also providing a writable tmpfs /run so the entrypoint can render the HAProxy config. Includes a podman run example, a Quadlet unit, and an SELinux note.

Benefits of this PR and context:

Urges users to use a non-root user inside the container. Also suppresses the HAProxy warning regarding this issue.

How Has This Been Tested?

Good working of endpoints with a non-root user.

Document how to run the socket proxy as an unprivileged user (nobody, UID/GID 65534) under rootless Podman, in addition to the existing "docker user in a rootless environment" case where the container process still runs as root inside its namespace.

Covers the two requirements needed for this to work: mapping the host user onto the in-container user via --userns=keep-id so the mounted Podman socket is readable.

Also providing a writable tmpfs /run so the entrypoint can render the HAProxy config. Includes a podman run example, a Quadlet unit, and an SELinux note.
@thespad thespad self-assigned this Jul 5, 2026
@thespad thespad added the documentation Improvements or additions to documentation label Jul 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

Development

Successfully merging this pull request may close these issues.

3 participants