Skip to content

Commit fddadc2

Browse files
committed
docs: Elaborate a bit on sysusers and /usr
Don't do it, make your /usr content root owned. Signed-off-by: Colin Walters <[email protected]>
1 parent a27199d commit fddadc2

File tree

1 file changed

+7
-0
lines changed

1 file changed

+7
-0
lines changed

docs/src/building/users-and-groups.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -95,6 +95,13 @@ of at build time. If `/etc` is persistent, this can avoid uid/gid drift (but
9595
in the general case it does mean that uid/gid allocation can
9696
depend on how a specific machine was upgraded over time).
9797

98+
Note that the default sysusers design is that users are allocated client
99+
side (per machine). Avoid trying to have non-root owned files managed
100+
by sysusers inside your image, especially underneath `/usr`. Aside from
101+
set{uid,gid} binaries (which should themselves be strongly avoided) there's
102+
really no good use case for having non-root owned files in `/usr` or other
103+
runtime immutable directories.
104+
98105
#### User and group home directories and `/var`
99106

100107
For systems configured with persistent `/home``/var/home`, any changes to `/var` made

0 commit comments

Comments
 (0)