Skip to content

hubcli user create

Creates a new Altair SLC Hub user.

The command has the following format:

hubcli user create [flags] username

flags
One or more optional flags that provide additional control over execution of the command.
username
The name for the new user.

The following flags are available:

-c string or --connection string
Specifies the name of the connection to use. If you do not specify this option, then the default connection is used. If there is no default connection, then you must specify a connection. The first connection created for the Altair SLC Hub instance is set by default as the default Altair SLC Hub instance, but a different default connection can be set using the hubcli connection use command.
--debug
Enables debug logging.
--displayName text
Specifies a display name for the user. This enables you to provide a more user-friendly name that can be displayed in lists and the Altair SLC Hub Portal.
--email address
Specifies the email address of the user.
-h or --help
Returns help information for this command.
--lastName name
Specifies the last name of the user.
--password pwd
Specifies a password for the user. If you do not specify a password, you will be prompted to provide one. The password must meet the password policy configured for the Altair SLC Hub instance.
--temporary
Specifies that the password created is temporary, and the user will need to use it at first login.
--unixHomeDirectory dir
Specifies the Unix home directory to associate with the user.
--unixUserName uname
Specifies a Unix username for the user.
--userPrincipalName upn
Specifies a Windows UPN for the user.

Examples

The following command creates a new user jsmith with display name, email, name, and Unix settings:

hubcli user create jsmith --displayName="John Smith" [email protected] --firstName=John --lastName=Smith --unixUserName=jsmith --unixHomeDirectory=/home/jsmith

If no --password flag is provided, you are prompted to enter and confirm a password that meets the configured password policy:

Password policy:

 * minimum length 15
 * must not be contained in blacklist

enter password :
confirm password :
User jsmith successfully created

Running hubcli user get jsmith after creation confirms the user was created successfully:

 User Details
 User Name            jsmith
 Enabled              true
 Display Name         John Smith
 Email                [email protected]
 ID                   ede05508-9cb2-43a1-b7ee-bae86f7cd3ed
 Created              2026-09-09 08:17:56 UTC
 Unix Username        jsmith
 Unix Home Directory  /home/jsmith