Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages

Manual Reference Pages  -  SSS_USERADD (8)

.ds Aq ’


sss_useradd - create a new user



sss_useradd [options] LOGIN


sss_useradd creates a new user account using the values specified on the command line plus the default values from the system.


-u,--uid UID

Set the UID of the user to the value of UID. If not given, it is chosen automatically.

-c,--gecos COMMENT

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

-h,--home HOME_DIR

The home directory of the user account. The default is to append the LOGIN name to /home and use that as the home directory. The base that is prepended before LOGIN is tunable with \(lquser_defaults/baseDirectory\(rq setting in sssd.conf.

-s,--shell SHELL

The users login shell. The default is currently /bin/bash. The default can be changed with \(lquser_defaults/defaultShell\(rq setting in sssd.conf.

-G,--groups GROUPS

A list of existing groups this user is also a member of.


Create the users home directory if it does not exist. The files and directories contained in the skeleton directory (which can be defined with the -k option or in the config file) will be copied to the home directory.


Do not create the users home directory. Overrides configuration settings.

-k,--skel SKELDIR

The skeleton directory, which contains files and directories to be copied in the users home directory, when the home directory is created by sss_useradd.

Special files (block devices, character devices, named pipes and unix sockets) will not be copied.

This option is only valid if the -m (or --create-home) option is specified, or creation of home directories is set to TRUE in the configuration.

-Z,--selinux-user SELINUX_USER

The SELinux user for the users login. If not specified, the system default will be used.


Display help message and exit.


In order to function correctly, a domain with \(lqid_provider=local\(rq 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)) 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.


sssd(8), sssd.conf(5), sssd-ldap(5), sssd-krb5(5), sssd-simple(5), sssd-ipa(5), sssd-ad(5), sssd-sudo(5), sss_cache(8), sss_debuglevel(8), sss_groupadd(8), sss_groupdel(8), sss_groupshow(8), sss_groupmod(8), sss_useradd(8), sss_userdel(8), sss_usermod(8), sss_obfuscate(8), sss_seed(8), sssd_krb5_locator_plugin(8), sss_ssh_authorizedkeys(8), sss_ssh_knownhostsproxy(8), sssd-ifp(5), pam_sss(8).


The SSSD upstream -

Search for    or go to Top of page |  Section 8 |  Main Index

SSSD SSS_USERADD (8) 04/16/2016

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.