Skip to content

Add podman userns option and id mappings #649

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
infotexture merged 3 commits into from
Dec 7, 2025
Merged

Add podman userns option and id mappings #649

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
f8ed292
Add podman userns option and id mappings
Dec 1, 2025
a6bc7bd
use xpr file to prettify change
Dec 1, 2025
bb3e971
Run Prettier to fix failing formatting check
infotexture Dec 7, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 10 additions & 3 deletions topics/using-docker-images.dita
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,10 +31,17 @@
<p>When a container is stopped, any changes made within the container are lost, so source files and generated
output should be stored outside the container. These resources are attached to the container by mounting
directories from the host machine.</p>
<note>If you use
<note type="important">If you use
<xref href="https://podman.io/" format="html" scope="external">Podman</xref> to manage and run your containers,
you can substitute <cmdname>podman</cmdname> for the <cmdname>docker</cmdname> command in the instructions
below.</note>
<xref
href="https://github.com/containers/podman/blob/main/docs/tutorials/rootless_tutorial.md#using-volumes"
format="html"
scope="external"
>you must substitute</xref>
<userinput>podman --userns=keep-id:uid=<varname>UID</varname>,gid=<varname>GID</varname></userinput> for the
<cmdname>docker</cmdname> command in the instructions below. For DITA-OT versions 4.2.3 and earlier, both
<varname>UID</varname> and <varname>GID</varname> are <userinput>1000</userinput>. For all later DITA-OT
versions, both values are <userinput>1001</userinput>.</note>
</section>
<prereq>
<p>To run the DITA-OT image, you will need to install Docker and be able to access the GitHub Container Registry.
Expand Down