Skip to content
Merged
Changes from 1 commit
Commits
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
Prev Previous commit
Next Next commit
Added documentation on unprivileged LXC containers
Co-developed-by: Jake Chacko <[email protected]>
Co-developed-by: Rahik Sikder <[email protected]>
Signed-off-by: Jake Chacko <[email protected]>
  • Loading branch information
chackoj-1204 committed Dec 12, 2025
commit f085a8cbd16ea20279220858887a9df9c4a9fc33
15 changes: 15 additions & 0 deletions doc/lxc.sgml.in
Original file line number Diff line number Diff line change
Expand Up @@ -206,6 +206,21 @@ rootfs
</para>
</refsect2>

<refsect2>
<title>Unprivileged containers</title>
<para>
Unprivileged LXC containers run without root host-level privileges in a
user namespace, mapping container UID 0 to a non-root host ID, which
strictly limits the accessible devices and filesystems of the
container. In order to mount a rootfs in an unprivileged container, the
mapped host user must have execute permissions for all directories
along the path to and including the rootfs. Additionally, all files and
directories under the rootfs must be owned by the correct user ID and
group ID. The correct user ID and group ID are the host IDs mapped to
the container root(UID 0) in lxc.idmap.
</para>
</refsect2>

<refsect2>
<title>Creating / Destroying containers</title>
<para>
Expand Down