How to install N3uron using the official installation script on an EG series gateway?

How to install N3uron using the official installation script on an EG series gateway?

πŸ“– Overview

This guide provides instructions for installing N3uron, a powerful industrial IoT edge platform, on Robustel EG Series gateways running RobustOS Pro.

Integrating N3uron with Robustel's edge hardware allows for seamless data orchestration, protocol conversion (such as Modbus to MQTT), and advanced edge computing capabilities. By leveraging the Debian-based architecture of RobustOS Pro, N3uron can run natively as a service, providing a robust environment for industrial automation and digitalization projects.

πŸ›  What You'll Need

  • Hardware:
    • Robustel Edge Gateway ((e.g., EG5120,EG5200).
  • Firmware:
    • RobustOS Pro: v2.3.0 or newer.
    • SSH Client (e.g., PuTTY, TeraTerm, or Windows PowerShell/Command Prompt).
  • Other
    • Internet Access: The gateway must have an active internet connection.

πŸ“ Note: If your gateway is not yet connected to the internet, please refer to the relevant documentation on configuring cellular or Ethernet WAN connectivity.

    • Sudo User Account: A user with sudo privileges must be created in the device configuration page.

πŸ“ Note: Refer to How to create a sudo user with SSH access on an EG series device to create a user if one does not exist.

πŸš€ Step-by-Step Configuration Guide

1️⃣ Step 1: Establish SSH Connection

  1. Open your SSH client or terminal.
  2. Connect to the device using the IP address and the sudo user credentials created in the prerequisites.
ssh <username>@<device_ip_address>
  1. Enter the password when prompted.

2️⃣ Step 2: Run the Automatic Installation Script

  1. Execute the following command to download and run the N3uron installation script:
curl -fsSL https://get.n3uron.com/install.sh | sudo bash

πŸ“ Note: The system may prompt you to enter the password for your sudo user to authorize the installation.

  1. Wait for the installation process to complete.

⚠️ Warning: Do not interrupt the process until you see a "Successfully installed" message on the terminal. Interruptions may lead to corrupted service files.

βœ… Verification & Testing

1. Verify Service Status

To ensure the N3uron service is running correctly, use the following command:

systemctl status n3uron

βœ… Success: The output should show Active: active (running).The N3uron service is active and initialized.

2. Access the WebUI

  1. Open a web browser on a PC connected to the same network.
  2. Navigate to the gateway's LAN IP address on port 8003.

πŸ“ Note: If you need to access the WebUI via the WAN port, you must open port 8003 in the Firewall settings.

βœ… Success: If successful, the N3uron login or dashboard page will appear.

Next, you can refer to the β€œHow to Quickly Get Started with N3uron After Installing It on a Robustel Gateway” article to quickly get started with N3uron’s features. For more details, please refer to the official documentation.

❓ Troubleshooting / FAQ

  • Q: The installation script fails with a "connection timed out" error.
    • A: Ensure the gateway has a valid DNS server configured (e.g., 8.8.8.8) in the Network > WAN settings.
  • Q: I cannot access the WebUI on port 8003.
    • A: Check if the service is running using systemctl status n3uron. If it is running, verify that no other service is occupying port 8003.
  • Q: How do I install N3uron using Docker instead?

πŸ“œ Revision History

Version

Date

Author

Notes

v1.0

2026-01-28

Jens Zhou

Initial document creation.