---
name: "sss_usermod"
section: "8"
platform: "linux"
package: "sssd-tools"
version: "1.16.3-3.2"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/sss_usermod"
---

# sss\_usermod(8)

modify a user account

## NAME

sss\_usermod - modify a user account

## SYNOPSIS

**sss\_usermod** \[*options*\] *LOGIN*

## DESCRIPTION

**sss\_usermod** modifies the account specified by *LOGIN* to reflect the changes that are specified on the command line.

## OPTIONS

- **-c**,**--gecos** *COMMENT*

  Any text string describing the user. Often used as the field for the user's full name.

- **-h**,**--home** *HOME\_DIR*

  The home directory of the user account.

- **-s**,**--shell** *SHELL*

  The user's login shell.

- **-a**,**--append-group** *GROUPS*

  Append this user to groups specified by the *GROUPS* parameter. The *GROUPS* parameter is a comma separated list of group names.

- **-r**,**--remove-group** *GROUPS*

  Remove this user from groups specified by the *GROUPS* parameter.

- **-l**,**--lock**

  Lock the user account. The user won't be able to log in.

- **-u**,**--unlock**

  Unlock the user account.

- **-Z**,**--selinux-user** *SELINUX\_USER*

  The SELinux user for the user's login.

- **--addattr** *ATTR\_NAME\_VAL*

  Add an attribute/value pair. The format is attrname=value.

- **--setattr** *ATTR\_NAME\_VAL*

  Set an attribute to a name/value pair. The format is attrname=value. For multi-valued attributes, the command replaces the values already present

- **--delattr** *ATTR\_NAME\_VAL*

  Delete an attribute/value pair. The format is attrname=value.

- **-?**,**--help**

  Display help message and exit.

## THE LOCAL DOMAIN

In order to function correctly, a domain with “id\_provider=local” must be created and the SSSD must be running.

The administrator might want to use the SSSD local users instead of traditional UNIX users in cases where the group nesting (see [**sss\_groupadd**(8)](/sss_groupadd/8.md)) is needed. The local users are also useful for testing and development of the SSSD without having to deploy a full remote server. The **sss\_user\*** and **sss\_group\*** tools use a local LDB storage to store users and groups.

## SEE ALSO

[**sssd**(8)](/sssd/8.md), [**sssd.conf**(5)](/sssd.conf/5.md), [**sssd-ldap**(5)](/sssd-ldap/5.md), [**sssd-krb5**(5)](/sssd-krb5/5.md), [**sssd-simple**(5)](/sssd-simple/5.md), [**sssd-ipa**(5)](/sssd-ipa/5.md), [**sssd-ad**(5)](/sssd-ad/5.md), [**sssd-sudo**(5)](/sssd-sudo/5.md), [**sssd-secrets**(5)](/sssd-secrets/5.md), [**sssd-session-recording**(5)](/sssd-session-recording/5.md), [**sss\_cache**(8)](/sss_cache/8.md), [**sss\_debuglevel**(8)](/sss_debuglevel/8.md), [**sss\_groupadd**(8)](/sss_groupadd/8.md), [**sss\_groupdel**(8)](/sss_groupdel/8.md), [**sss\_groupshow**(8)](/sss_groupshow/8.md), [**sss\_groupmod**(8)](/sss_groupmod/8.md), [**sss\_useradd**(8)](/sss_useradd/8.md), [**sss\_userdel**(8)](/sss_userdel/8.md), [**sss\_usermod**(8)](/sss_usermod/8.md), [**sss\_obfuscate**(8)](/sss_obfuscate/8.md), [**sss\_seed**(8)](/sss_seed/8.md), [**sssd\_krb5\_locator\_plugin**(8)](/sssd_krb5_locator_plugin/8.md), **sss\_ssh\_authorizedkeys**(8), **sss\_ssh\_knownhostsproxy**(8), [**sssd-ifp**(5)](/sssd-ifp/5.md), [**pam\_sss**(8)](/pam_sss/8.md). [**sss\_rpcidmapd**(5)](/sss_rpcidmapd/5.md) [**sssd-systemtap**(5)](/sssd-systemtap/5.md)

## AUTHORS

**The SSSD upstream - https://pagure.io/SSSD/sssd/**