Overview
For security and user management purposes, it is often necessary to create a non-root user that still has administrative privileges. This guide provides instructions on how to create a sudo user on a Robustel gateway running RobustOS Pro. This user will be able to log in to the device's command-line interface (CLI) via SSH and execute commands with root permissions, enhancing system security by avoiding direct root login.
What You'll Need
- 1 x Robustel Gateway (e.g., EG5120, EG5200) .
- RobustOS Pro firmware V2.3.0 or higher.
- An SSH client application (e.g., PuTTY for Windows, or the built-in Terminal for macOS and Linux).
Step-by-Step Configuration Guide
Create the Sudo User in the Web GUI
- Navigate to System -> User Management from the left-hand menu.
- Click the Sudo User tab
- Under the Sudo User Settings section. click on the "+" icon to create a new user with sudo privileges.
- A configuration window will appear. Fill in the following fields:
- New username: Enter the desired username (e.g.,
Robustel). - New Password: Enter a strong password for the user.
- Confirm Password: Re-enter the password to confirm.
- Click the Submit button.
- Click the Save & Apply icon in the top-right corner of the page to make the changes take effect.
Verification & Testing
- Open your SSH client (Terminal on macOS/Linux or an application like PuTTY on Windows).
- Connect to the gateway using the new username and the gateway's IP address. The command format is
ssh <username>@<gateway_ip>.
ssh Robustel@192.168.0.1
- When prompted, enter the password you created for the sudo user in the previous step. You will now be logged into the gateway's command-line interface.
- To run commands that require root privileges, prefix the command with
sudo. For example, to view the contents of the root directory, you would use:
sudo ls /root
You may be asked to enter the user's password again for verification. If the system prompts for your password and then successfully executes the command, your sudo user is configured correctly.
Troubleshooting / FAQ
- Q1: I'm getting a "Connection refused" error when trying to SSH.
- A1: Ensure that SSH access is enabled on the gateway. Navigate to Services -> SSH and verify that the "Enable" toggle is ON. Also, check your firewall settings under Network -> Firewall -> Access Control Settings to make sure "Enable SSH Access" from your network is permitted.
- Q2: I receive a "Permission denied" error during SSH login.
- A2: This typically means the username or password is incorrect. Passwords are case-sensitive. Please double-check the credentials you configured in System -> User Management.
- Q3: Can I log into the Web GUI with this new sudo user?
- A3: No. The sudo user created via the method above is for command-line access (SSH) only. To create a user account for the web interface, you must add a Common User under System -> User Management and assign it a "Guest" or "User" role.
Revision History
Version | Date | Author | Changes |
1.0 | 2025-09-26 | Jens Zhou | Initial document creation. |