Search notes:

Shell command: usermod

usermod can be used to modify a user's account, for example to add a user to /etc/group.

Command line options

-b --badnames allow bad names
-c --comment COMMENT new value of the GECOS field
-d --home HOME_DIR new home directory for the user account. See also -m
-e --expiredate EXPIRE_DATE set account expiration date to EXPIRE_DATE
-f --inactive INACTIVE set password inactive after expiration to INACTIVE
-g --gid GROUP force use GROUP as new primary group
-G --groups GROUPS new list of supplementary (aka secondary?) GROUPS
-a --append append the user to the supplemental GROUPS mentioned by the -G option without removing the user from other groups
-h --help display this help message and exit
-l --login NEW_LOGIN new value of the login name
-L --lock lock the user account
-m --move-home move contents of the home directory to the new location (use only with -d)
-o --non-unique allow using duplicate (non-unique) UID
-p --password PASSWORD use encrypted password for the new password
-R --root CHROOT_DIR directory to chroot into
-P --prefix PREFIX_DIR prefix directory where are located the /etc/* files
-s --shell SHELL new login shell for the user account
-u --uid UID new UID for the user account
-U --unlock unlock the user account
-v --add-subuids FIRST-LAST add range of subordinate uids
-V --del-subuids FIRST-LAST remove range of subordinate uids
-w --add-subgids FIRST-LAST add range of subordinate gids
-W --del-subgids FIRST-LAST remove range of subordinate gids
-Z --selinux-user SEUSER new SELinux user mapping for the user account

Adding a user to a group

A user is added to a group with the usermod command:
sudo usermod -aG group-name user-name

See also

useradd to create a new user.
/etc/passwd, /etc/group
Shell commands

Index