Skip to content

Linux useradd Guide

Mattscreative edited this page Dec 5, 2025 · 2 revisions

Linux useradd Guide

Complete beginner-friendly guide to useradd on Linux, covering Arch Linux, CachyOS, and other distributions including creating users, user configuration, and user management.


Table of Contents

  1. Understanding useradd
  2. Creating Users
  3. User Configuration
  4. User Management
  5. Troubleshooting

Understanding useradd

What is useradd?

useradd creates new user accounts.

Uses:

  • Create users: Add new user accounts
  • Set defaults: Configure user defaults
  • User management: Manage system users
  • Multi-user systems: Support multiple users

Why it matters:

  • Security: Separate user accounts
  • Organization: Organize system access
  • Permissions: Control file access

Creating Users

Basic User Creation

Create user:

# Create user
sudo useradd username

# Create with home directory
sudo useradd -m username

# Set password
sudo passwd username

User with Groups

Add to groups:

# Create user in wheel group
sudo useradd -m -G wheel username

# Create with specific UID
sudo useradd -m -u 1001 username

User Configuration

User Options

Common options:

# Create user with options
sudo useradd -m -s /bin/bash -G wheel,users username

# Options:
# -m: Create home directory
# -s: Set shell
# -G: Add to groups
# -u: Set UID
# -g: Set primary group

Default Shell

Set shell:

# Create with zsh
sudo useradd -m -s /bin/zsh username

# Create with fish
sudo useradd -m -s /usr/bin/fish username

User Management

Modify User

Change user:

# Modify user
sudo usermod -aG group username

# Change shell
sudo usermod -s /bin/zsh username

# Lock account
sudo usermod -L username

Delete User

Remove user:

# Delete user
sudo userdel username

# Delete with home directory
sudo userdel -r username

Troubleshooting

User Creation Errors

Check issues:

# Check if user exists
id username

# Check groups
groups username

# Check home directory
ls -la /home/username

Summary

This guide covered useradd usage, user creation, and management for Arch Linux, CachyOS, and other distributions.


Next Steps


This guide covers Arch Linux, CachyOS, and other Linux distributions. For distribution-specific details, refer to your distribution's documentation.

Clone this wiki locally