Skip to content

Commit 6893403

Browse files
authored
Merge pull request #1457 from cgwalters/doc-non-root
docs: Elaborate a bit on sysusers and /usr
2 parents d35d235 + e2d21f7 commit 6893403

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 on the client
99+
side (per machine). Avoid having non-root owned files managed by `sysusers`
100+
inside your image, especially underneath `/usr`. With the exception of
101+
`setuid` or `setgid` binaries (which should also be strongly avoided), there is
102+
generally no valid reason 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)