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 - 59999.

       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 - 59999.

       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

       addgroup(8), adduser(8), delgroup(8), deluser(8), deluser.conf(5)