Back to Commands

userdel

user managementLinux/Unix

The userdel command is one of the most frequently used commands in Linux/Unix-like operating systems. userdel Delete a user account and related files

See Examples View Syntax

Quick Reference

Command Name:

userdel

Category:

user management

Platform:

Linux/Unix

Basic Usage:

userdel [options] [arguments]

Common Use Cases

Syntax

userdel [options] LOGIN

Options

Option	Description
`-f, --force`	Force removal of files, even if not owned by user
`-h, --help`	Display help message and exit
`-r, --remove`	Remove home directory and mail spool
`-R, --root CHROOT_DIR`	Apply changes in CHROOT_DIR directory
`-P, --prefix PREFIX_DIR`	Apply changes in PREFIX_DIR directory
`-Z, --selinux-user`	Remove any SELinux user mapping for the user's login

Examples

How to Use These Examples

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

# Basic Examples Basic

# Delete a user account sudo userdel johndoe

# Delete a user account and their home directory sudo userdel -r johndoe

# Advanced Examples Advanced

# Delete a user account and forcefully remove all files sudo userdel -rf johndoe

# Delete a user and remove their home directory only if it's in the default location sudo userdel -r johndoe

# Delete a user but ensure their mail spool is preserved sudo userdel -r -Z johndoe # Delete a user and check if they are still logged in if who | grep -q "^johndoe "; then echo "User is logged in. Please ask them to log out first." else sudo userdel -r johndoe fi # Delete a user after backing up their home directory sudo tar -czf /backup/johndoe-home-$(date +%Y%m%d).tar.gz /home/johndoe sudo userdel -r johndoe # Delete a user after changing ownership of their files in shared directories sudo find /shared -user johndoe -exec chown newowner:newgroup {} \; sudo userdel johndoe # Script to delete multiple users from a list

cat users_to_delete.txt | while read username; do

sudo userdel -r "$username" echo "Deleted user $username" done # Delete a user but keep their group if others are members if [ $(grep -c "^somegroup:" /etc/group) -gt 0 ]; then members=$(grep "^somegroup:" /etc/group | cut -d: -f4) if [ -n "$members" ]; then # Keep the group as it has other members sudo userdel johndoe else # Remove the group as well sudo userdel -r johndoe fi fi

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 `userdel` command is a system administration utility used in Linux and Unix-like operating systems to delete user accounts. It's an essential tool for managing users on a system, allowing administrators to remove user accounts that are no longer needed. When executed, `userdel` removes the user's entry from the system account files (`/etc/passwd`, `/etc/shadow`, etc.). By default, it doesn't remove the user's home directory or mail spool, but these can be removed with additional options. **Key Behaviors and Features:** 1. **Basic Operation**: Without any options, `userdel` simply removes the user's entries from system account files. This includes removing the user from `/etc/passwd`, `/etc/shadow`, and from any groups in `/etc/group` that the user belongs to. 2. **Home Directory Removal**: The `-r` option is commonly used to remove the user's home directory along with the user account. This includes all files and subdirectories in the user's home directory. Be cautious with this option, as it permanently deletes all of the user's files. 3. **Force Removal**: The `-f` option forces the deletion even if the user is still logged in or has processes running. This can lead to system instability if used carelessly. It also forces the removal of files even if they're not owned by the user being deleted. 4. **Mail Spool Removal**: The `-r` option also removes the user's mail spool, which is typically located at `/var/spool/mail/username` or `/var/mail/username`. 5. **SELinux User Mapping**: In systems with SELinux enabled, the `-Z` option removes any SELinux user mapping for the user's login. **Cautions and Best Practices:** 1. **Backup Before Deletion**: Before deleting a user account, especially with the `-r` option, it's often a good practice to back up the user's home directory in case the data is needed later. 2. **Check for Running Processes**: Before deleting a user, check if they have any running processes using commands like `ps -u username`. Killing these processes before deletion can prevent system issues. 3. **Ownership of Files Outside Home**: Users might own files outside their home directory. These files won't be automatically removed by `userdel -r`. Use `find / -user username` to locate all files owned by a user before deletion. 4. **Cron Jobs and Services**: Check for any cron jobs (`crontab -u username -l`) or system services running as the user before deletion. 5. **Group Ownership**: If the user is the owner of any groups and these groups have other members, you might want to reassign group ownership before deleting the user. **Comparison with Other User Management Commands:** - **`useradd`**: Used to create new user accounts. - **`usermod`**: Used to modify existing user accounts. - **`deluser`**: On some distributions, this is a higher-level wrapper around `userdel` with additional features. **System Impact:** The `userdel` command directly modifies critical system files. Errors in user deletion could potentially cause system instability or security issues. It's always recommended to have backups of the system and user data before performing user management operations, especially deletions. In multi-user environments, it's essential to coordinate user deletion with other administrators and the users themselves to ensure a smooth transition and prevent data loss or service disruption. Proper documentation of user deletion processes and policies is also a best practice in enterprise environments.

Related Commands

These commands are frequently used alongside userdel 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 userdel command works in different scenarios.

See Examples Try Lab Exercises

$ userdel

View All Commands