Back to Commands

gpasswd

user managementLinux/Unix

The gpasswd command is one of the most frequently used commands in Linux/Unix-like operating systems. gpasswd Administer the /etc/group file

See Examples View Syntax

Quick Reference

Command Name:

gpasswd

Category:

user management

Platform:

Linux/Unix

Basic Usage:

gpasswd [options] [arguments]

Common Use Cases

Syntax

gpasswd [option] group

Options

Option	Description
`-a, --add user`	Add user to the specified group
`-d, --delete user`	Remove user from the specified group
`-h, --help`	Display help message and exit
`-A, --administrators user,...`	Set the list of administrators for the group
`-M, --members user,...`	Set the list of members for the group
`-r, --remove-password`	Remove the group's password
`-R, --restrict`	Restrict access to the group to its members

Examples

How to Use These Examples

The examples below show common ways to use the gpasswd command. Try them in your terminal to see the results. You can copy any example by clicking on the code block.

# Basic Examples Basic

gpasswd developers

Set the password for the developers group.

gpasswd -a username developers

Add a user to the developers group.

gpasswd -d username developers

Remove a user from the developers group. # Advanced Examples Advanced gpasswd -A admin1,admin2 developers Set admin1 and admin2 as administrators for the developers group. gpasswd -M user1,user2,user3 developers Set the member list for the developers group to exactly user1, user2, and user3. gpasswd -r developers Remove the password from the developers group.

Try It Yourself

Practice makes perfect! The best way to learn is by trying these examples on your own system with real files.

Understanding Syntax

Pay attention to the syntax coloring: commands, options, and file paths are highlighted differently.

Notes

The gpasswd command is a system administration tool used to manage group accounts on Linux and Unix-like systems. It provides a range of functionality for adding and removing users from groups, setting group administrators, and managing group passwords. Key features of gpasswd: 1. Group Membership Management: gpasswd allows administrators to add users to or remove users from groups, facilitating access control and resource sharing. 2. Group Password Administration: It can set, change, or remove the password for a group, which may be required for users to join the group (when group joining is restricted). 3. Group Administrator Assignment: System administrators can delegate group management by assigning specific users as group administrators, who can then add or remove members. 4. Complete Member List Control: With the -M option, administrators can set the exact membership of a group, replacing all existing members with a new list. 5. Access Restriction: The -R option restricts access to the group to its members only, requiring users to use the newgrp command with the group password to temporarily join. 6. Security Enhancement: By providing a way to delegate group management, gpasswd helps implement the principle of least privilege in system administration. 7. System File Management: Under the hood, gpasswd manages entries in system files like /etc/group and /etc/gshadow. The gpasswd command is particularly useful in multi-user environments where granular control over group membership is necessary. It's typically used by system administrators to organize users into functional groups for permission management, resource sharing, and collaboration.

Related Commands

These commands are frequently used alongside gpasswd or serve similar purposes:

Explore All Commands

Use Cases

Learn By Doing

The best way to learn Linux commands is by practicing. Try out these examples in your terminal to build muscle memory and understand how the gpasswd command works in different scenarios.

See Examples Try Lab Exercises

$ gpasswd

View All Commands