Linux: Users and Groups

By Xah Lee. Date: . Last updated: .

This page is a basic tutorial on managing Linux users and groups.

On a linux machine, there are:

  1. A set of users.
  2. A set a groups.
  3. Each user has a name and a user ID called uid. (positive integer)
  4. Each group has a name and a group ID called gid. (positive integer)
  5. Each user belongs to at least one group.
  6. One of the group the user belongs to is called his primary group.
  7. The default admin user is named “root”, and its uid is 0.

Listing {user, group}, Finding {uid, gid}

Show a user's uid

# show a user's uid
id myLoginName
linux id command 2017 04 18
use “id” command to show user and group.

List all users

It's stored in the file /etc/passwd.

# list all users on a machine
cat /etc/passwd | awk -F\: '{print $1}'

Here's a sample passwd file:


Each line is a colon separated field. The values mean these:

  1. login name
  2. optional encrypted password
  3. numerical user ID
  4. numerical group ID
  5. user name or comment field
  6. user home directory
  7. optional user command interpreter (shell path)

For detail, type man 5 passwd.

Show a group's gid

It's stored in the file /etc/group.

# list all group names
cat /etc/group

Here's a sample group file content:



Each line is a colon separated field. The values mean these:

  1. group name
  2. password (not really used in practice)
  3. group id (gid)
  4. list of users that belongs to this group, separated by comma.

See man 5 group.

List all groups

cat /etc/group

Find the primary group of a user

id user_name

Sample output:

uid=1000(joe) gid=1000(joe) groups=1000(joe),4(adm),20(dialout),24(cdrom),46(plugdev),116(lpadmin),118(admin),124(sambashare)

The “gid=1000(joe)” is the primary group the user belongs to. In this example, my user name is “joe”, uid is 1000, and there's a group also named “joe” with gid 1000, and it's primary group joe belongs to.

The “groups=…” are all the groups the user belongs to.

Creating/Modifying {user, group}

Create a new user

useradd new_name. The “useradd” is a low-level command. On Debian based Linuxes, there's a higher-level command adduser you can use.

When you create a user, several other things must happen too. For example, creating a home dir for the user, specify the user's login shell path, specify the user's primary group.

Use useradd -D to see the defaults.

joe@joe-VirtualBox ◆  2012-10-13 ◆ 04:00  ◆ ~
useradd -D


Create a new group

groupadd new_name, or addgroup.

See their man page for detail.

Change the primary group for a user

sudo usermod -g new_group_name user_name

The group for all files of user's home dir will be changed too. But for other files, you'll need to change yourself.

Add a user to a group

sudo usermod -a -G new_group_name user_name

The user needs to re-login for his new group to have effect.

Remove a user from a group

First, find out all the groups the user belongs, by id user_name, then use sudo usermod -G comma_separated_group_names user_name. The “-G” option take a list of all the groups the user should belong to.

Create multiple users in batch

newusers users_data_file. The users_data_file is a text file containing user info. Each line should have the same format as the /etc/passwd file. See: man newusers.

If you have a question, put $5 at patreon and message me.

Linux Shell Basics

  1. Get System Info
  2. Shell Basics
  3. grep, cat, awk, uniq
  4. sort
  5. find, xargs
  6. diff Files/Dir
  7. dir size: du
  8. dir tree
  9. tar gzip bzip2 xz 7zip rar zip
  10. wget, curl
  11. rsync
  12. Install Packages

Sys Admin

  1. Job Control
  2. ps
  3. top
  4. htop
  5. RAM stat
  6. Users and Groups
  7. File Permission
  8. Opened Files: lsof
  9. shutdown, sleep


  1. Bash/Terminal Keys
  2. Man Page Keys
  3. Bash Prompt Setup
  4. Bash Color Prompt
  5. .bashrc, .profile, .bash_profile
  6. Virtual Console
  7. Terminal Control Sequence Keys
  8. Ctrl+s Freeze vim
  9. Reset Terminal
  10. tmux
  11. Bash Manual in Chapters
  12. Bash Misc Tips
  13. Log Terminal Session

Linux Desktop

  1. Useful GUI App Names
  2. Set Default App
  3. Commands for GUI Apps
  4. Image Viewers
  5. Music Players
  6. Move to Trash Command
  7. X11 Selection and Clipboard
  8. Switch to LXDE/Xfce
  9. LXDE Keys
  10. LXDE/Openbox, Change Keys
  11. LXDE Set Key Repeat Rate
  12. LXDE/OpenBox, Disable Mouse Scroll Wheel Hide Window
  13. Xfce Keys
  14. Xfce Good Themes
  15. xmonad Keybinding
  16. How to Restart X11
  17. Why Tiling Window Manager Sucks
  18. Standard Fonts
  19. How to Install Font