usermod

linux

Modify a user account. See also: `users`, `useradd`, `userdel`.

More info →

Options (9)

-l, --loginboolean

Change a username

Example: sudo usermod {{[-l|--login]}} {{new_username}} {{username}}

-u, --uidboolean

Change a user ID

Example: sudo usermod {{[-u|--uid]}} {{id}} {{username}}

-s, --shellboolean

Change a user shell

Example: sudo usermod {{[-s|--shell]}} {{path/to/shell}} {{username}}

boolean

Add a user to supplementary groups (mind the lack of whitespace)

Example: sudo usermod {{[-aG|--append --groups]}} {{group1,group2,...}} {{username}}

boolean

Remove a user from specific groups

Example: sudo usermod {{[-rG|--remove --groups]}} {{group1,group2,...}} {{username}}

-m, --move-homeboolean

Change a user home directory

Example: sudo usermod {{[-m|--move-home]}} {{[-d|--home]}} {{path/to/new_home}} {{username}}

-d, --homeboolean

Change a user home directory

Example: sudo usermod {{[-m|--move-home]}} {{[-d|--home]}} {{path/to/new_home}} {{username}}

-L, --lockboolean

Lock an account

Example: sudo usermod {{[-L|--lock]}} {{username}}

-U, --unlockboolean

Unlock an account

Example: sudo usermod {{[-U|--unlock]}} {{username}}

Examples (8)

Change a username

sudo usermod [-l|--login] new_username username

Change a user ID

sudo usermod [-u|--uid] id username

Change a user shell

sudo usermod [-s|--shell] path/to/shell username

Add a user to supplementary groups (mind the lack of whitespace)

sudo usermod [-aG|--append --groups] group1,group2,... username

Remove a user from specific groups

sudo usermod [-rG|--remove --groups] group1,group2,... username

Change a user home directory

sudo usermod [-m|--move-home] [-d|--home] path/to/new_home username

Lock an account

sudo usermod [-L|--lock] username

Unlock an account

sudo usermod [-U|--unlock] username

made by @shridhargupta | data from tldr-pages