username

Last Updated : Aug 28, 2026 |
Use the username command to add a local user account. Use the no form of the command to remove the user account from the system.
Prolog information
Metadata
Keywords:
By default there is only a single user account named “root”, with the root password, which accesses the administrator level. You cannot delete this basic user account unless you have created a different administrator. You cannot modify the access level of the basic user account.
Note:
Removing the root user may disable access to the gateway, as the root account is the only account to which lockout, inactivity, and password aging mechanisms are not applied.
Important:
For security reasons, you must change the default root account password immediately.
Ensure that the password does not contain the username.

Syntax

username[name] access-type [access_type]
no username [name]

Parameters

Parameter
Description
Possible Values
Default Value
name
New user name
Minimum four character string
access_type
Access type definition
read-only, read-write, admin
-
Enter user’s password at the prompt
The password must comply with the password policies determined by login authentication min-password-length, login authentication min-password-upper-chars, login authentication min-password-lower-chars, login authentication min-password-digit-chars, and login authentication min-password-special-chars.

User Level

admin

Context

general

Example

To create a new user account with username john and a read-write access:
Gxxx-001(super)# username john access-type read-write 
Enter new password: ***************
Confirm password  : ***************
User account added.
To change the password of the root user:
Gxxx-001(super)# username root access-type admin 
Enter new password: ***************
Confirm password  : ***************
User account modified.
You cannot change the access type of the root user:Gxxx-001(super)# username root access-type read-write 
ERROR: User account root has always an administrator access type.
Note:
To define a username that includes spaces, you must enclose the entire name in quotation marks, for example, new york.