--- title: "Creating a user account using the appliance CLI" slug: "creating-a-user-account-using-the-appliance-cli-1" tags: ["File Protect (FX)", "Malware Analysis (AX)", "IAM", "Email Security - Cloud", "Network Security (NX)", "Email Security — Server", "Central Management System", "Helix Enterprise", "Endpoint Security (HX)", "Product Usage", "Install and Get Started", "Helix", "Intelligent Virtual Execution "] updated: 2026-09-01T19:03:07Z published: 2026-09-01T19:03:07Z canonical: "docs.trellix.com/creating-a-user-account-using-the-appliance-cli-1" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Creating a user account using the appliance CLI On a local system, you have the ability to add user accounts using the device's CLI. The instructions below will provide the steps necessary to add a user account locally. ### Note For a managed appliance, you can perform this procedure on the Central Management System appliance as well as the local appliance. The procedure remains the same. However, you will need to take the additional step to locate the appliance on the Central Management System CLI. For instructions on locating an appliance on the Central Management System CLI, see the *Trellix Central Management System Administration Guide*. ### Prerequisites - Admin access To add a new user account: 1. Go to CLI configuration mode: ``` hostname > enable hostname # configure terminal ``` 2. Add the user name with the `username` command. The following example creates the user account nx‑3_operator: ``` hostname (config) # username nx-3_operator ``` 3. Assign a role to the user account with the `username <username> role` sub-command. The following example assigns a role to the user account nx‑3_operator: ``` hostname (config) # username nx-3_operator role operator ``` 4. Assign a password to the user account with the `username <username> role <role> password` sub-command. The following example assigns the password `mArT!n1_@` to the user account nx‑3: ``` hostname (config) # username nx-3_operator password mArT!n1_@ ``` ### Note The command does not ask you to confirm the password. 5. (Optional) For monitor accounts only, configure a subnet and VLAN ID for the specified user account. Use the `username <username> subnet` and `username <usename> vlan` sub-commands: `username <username> subnet <networkPrefix>` `username <username> vlan <vlanNumber>` The following example configures the subnet and a VLAN ID for the user account nx‑3_operator: ``` hostname (config) # username ``` `hostname (config) # username nx-3_operator subnet 24 hostname (config) # username nx-3_operator vlan 22` 6. View your changes: ``` hostname (config) # show usernames ``` 7. Save your changes: ``` hostname (config) # write memory ``` To see the list of user accounts, enter the `show usernames` command. See [Viewing the list of accounts using the appliance CLI](/docs/viewing-the-list-of-accounts-using-the-appliance-cli). :