adduser.conf(5)                        File Formats Manual                        adduser.conf(5)



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/[group‐
              name]/user.  Defaults to no.

       LETTERHOMES
              If  this is set to yes, then the home directories created will have an extra direc‐
              tory  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  allo‐
              cated.  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  unal‐
              located.

       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  allo‐
              cated.  Default to 100 - 999.

       FIRST_GID and LAST_GID
              specify  an  inclusive  range of GIDs from which normal group's GIDs can be dynami‐
              cally 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 spec‐
              ified 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 ( USER‐
              GROUPS=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]*$.

       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, under‐
              scores,  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)



Debian GNU/Linux                        Version 3.113+nmu3                        adduser.conf(5)