systemd-sysusers man page

systemd-sysusers, systemd-sysusers.service ā€” Allocate system users and groups


systemd-sysusers [Options...] [CONFIGFILE...]



systemd-sysusers creates system users and groups, based on the file format and location specified in sysusers.d(5).

If invoked with no arguments, it applies all directives from all files found. If one or more filenames are passed on the command line, only the directives in these files are applied. If only the basename of a file is specified, all directories as specified in sysusers.d(5) are searched for a matching file. If the string "-" is specified instead of a filename, entries from the standard input of the process are read.


The following options are understood:


Takes a directory path as an argument. All paths will be prefixed with the given alternate root path, including config search paths.

-h, --help

Print a short help text and exit.


Print a short version string and exit.

Exit Status

On success, 0 is returned, a non-zero failure code otherwise.

See Also

systemd(1), sysusers.d(5)

Referenced By

systemd.directives(7), systemd.index(7), sysusers.d(5).

The man page systemd-sysusers.service(8) is an alias of systemd-sysusers(8).

systemd 237 systemd-sysusers