How to create a sudo user with SSH access on an EG series device?

How to create a sudo user with SSH access on an EG series device?

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

  • Hardware List:
    • 1 x Robustel Gateway (e.g., EG5120, EG5200) .
  • Software/Firmware:
    • 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).
  • Other:

Step-by-Step Configuration Guide

Create the Sudo User in the Web GUI

  1. Navigate to System -> User Management from the left-hand menu.
  2. Click the Sudo User tab
  3. Under the Sudo User Settings section. click on the "+" icon to create a new user with sudo privileges.
  4. 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.
  1. Click the Submit button.
  2. Click the Save & Apply icon in the top-right corner of the page to make the changes take effect.

Verification & Testing

  1. Open your SSH client (Terminal on macOS/Linux or an application like PuTTY on Windows).
  2. 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
  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.


  1. 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.


    • Related Articles

    • How to Install Telit deviceWISE Asset Gateway on Robustel EG Series Gateways?

      Overview This guide provides step-by-step instructions for installing the Telit deviceWISE Asset Gateway software on a Robustel EG series gateway (e.g., EG5120). This installation allows you to leverage the powerful edge computing and Industrial IoT ...
    • How to install the MQTT broker service on EG series devices?

      Overview This article provides a step-by-step guide for installing and configuring the Mosquitto MQTT broker on a Robustel EG series gateway (e.g., EG5120, EG5200) running RobustOS Pro. This setup is ideal for scenarios where you need a reliable, ...
    • How to access a RobustOS device via SSH?

      Overview Secure Shell (SSH) provides a secure, encrypted connection to your Robustel gateway, allowing for advanced command-line access. This is essential for developers, system administrators, and support engineers who need to perform in-depth ...
    • How to obtain and set DIDO in one's own application on the EG series devices?

      Overview When using Robustel's EG series gateways (like the EG5120 or EG3110) running RobustOS Pro, you often need to interact with the physical world through Digital Inputs (DI) and Digital Outputs (DO). For instance, you might need to read the ...
    • How to Update EG Series Device via USB

      This guide explains how to update your EG Series/RobustOS Pro device using a USB drive with the firmware package mg460-uuu-udisk-upgrade-2.1.5.tgz. Here take MG460 for example. ⚠️ Important Warning CAUTION: This process will restore the device to ...