NAME
/etc/adduser.conf - configuration file for adduser(8) and addgroup(8).
DESCRIPTION
The file /etc/adduser.conf contains defaults for the programs
adduser(8) , addgroup(8) , deluser(8) and delgroup(8). Each line holds
a single value pair in the form option = value. Double or single
quotes are allowed around the value, as is whitespace around the equals
sign. Comment lines must have a hash sign (#) in the first column.
The valid configuration options are:
DSHELL The login shell to be used for all new users. Defaults to
/bin/bash.
DHOME The directory in which new home directories should be created.
Defaults to /home.
GROUPHOMES
If this is set to yes, the home directories will be created as
/home/[groupname]/user. Defaults to no.
LETTERHOMES
If this is set to yes, then the home directories created will
have an extra directory inserted which is the first letter of
the loginname. For example: /home/u/user. Defaults to no.
SKEL The directory from which skeletal user configuration files
should be copied. Defaults to /etc/skel.
FIRST_SYSTEM_UID and LAST_SYSTEM_UID
specify an inclusive range of UIDs from which system UIDs can be
dynamically allocated. Default to 100 - 999. Please note that
system software, such as the users allocated by the base-passwd
package, may assume that UIDs less than 100 are unallocated.
FIRST_UID and LAST_UID
specify an inclusive range of UIDs from which normal user’s UIDs
can be dynamically allocated. Default to 1000 - 29999.
FIRST_SYSTEM_GID and LAST_SYSTEM_GID
specify an inclusive range of GIDs from which system GIDs can be
dynamically allocated. Default to 100 - 999.
FIRST_GID and LAST_GID
specify an inclusive range of GIDs from which normal group’s
GIDs can be dynamically allocated. Default to 1000 - 29999.
USERGROUPS
If this is set to yes, then each created user will be given
their own group to use. If this is no, then each created user
will be placed in the group whose GID is USERS_GID (see below).
The default is yes.
USERS_GID
If USERGROUPS is no, then USERS_GID is the GID given to all
newly-created users. The default value is 100.
DIR_MODE
If set to a valid value (e.g. 0755 or 755), directories created
will have the specified permissions as umask. Otherwise 0755 is
used as default.
SETGID_HOME
If this is set to yes, then home directories for users with
their own group ( USERGROUPS=yes ) will have the setgid bit set.
This was the default setting for adduser versions << 3.13.
Unfortunately it has some bad side effects, so we no longer do
this per default. If you want it nevertheless you can still
activate it here.
QUOTAUSER
If set to a nonempty value, new users will have quotas copied
from that user. The default is empty.
NAME_REGEX
User and group names are checked against this regular
expression. If the name doesn’t match this regexp, user and
group creation in adduser is refused unless --force-badname is
set. With --force-badname set, only weak checks are performed.
The default is the most conservative ^[a-z][-a-z0-9]*$. When
--system is specified, NAME_REGEX_SYSTEM is used instead.
NAME_REGEX_SYSTEM
Names of system users are checked against this regular
expression. If --system is supplied and the name doesn’t match
this regexp, user creation in adduser is refused unless --force-
badname is set. With --force-badname set, only weak checks are
performed. The default is as for the default NAME_REGEX but also
allowing uppercase letters.
SKEL_IGNORE_REGEX
Files in /etc/skel/ are checked against this regex, and not
copied to the newly created home directory if they match. This
is by default set to the regular expression matching files left
over from unmerged config files (dpkg-(old|new|dist)).
ADD_EXTRA_GROUPS
Setting this to something other than 0 (the default) will cause
adduser to add newly created non-system users to the list of
groups defined by EXTRA_GROUPS (below).
EXTRA_GROUPS
This is the list of groups that new non-system users will be
added to. By default, this list is ’dialout cdrom floppy audio
video plugdev users games’
NOTES
VALID NAMES
adduser and addgroup enforce conformity to IEEE Std 1003.1-2001,
which allows only the following characters to appear in group
and user names: letters, digits, underscores, periods, at signs
(@) and dashes. The name may no start with a dash. The "$" sign
is allowed at the end of usernames (to conform to samba).
An additional check can be adjusted via the configuration
parameter NAME_REGEX to enforce a local policy.
FILES
/etc/adduser.conf
SEE ALSO
adduser(8), addgroup(8), deluser(8), delgroup(8), deluser.conf(5)