📖 Overview

This document outlines the procedures for installing the Docker Engine on Robustel EG series edge computing gateways (running RobustOS Pro). By leveraging the device's Debian-based architecture, users can configure official Docker repositories to install the container runtime environment. A supplementary guide is also provided for offline installation using local .deb packages.

🛠 What You'll Need

Hardware List

• Robustel EG Series Gateway: e.g., EG5100, EG5120, EG5200.

Software/Firmware

• RobustOS Pro: 2.4.0.
• SSH Client: Such as PuTTY, Windows PowerShell, or macOS Terminal.

Other

• Internet Access: The gateway must have an active WAN connection (Cellular or Ethernet) to download packages via apt.

• Sudo User Account: A user account with sudo privileges must be created on the device.

🚀 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>

3. Enter the password when prompted.

2️⃣ Step 2: Set Up Docker's Apt Repository

To ensure you install the latest official version of Docker, you must add the official Docker repository to the device's source list.

1. Run the following commands block to install necessary certificates and add the Docker GPG key:

# Add Docker's official GPG key:
sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

2. Run the following block to add the repository to Apt sources:

# Add the repository to Apt sources:
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: $(. /etc/os-release && echo "$VERSION_CODENAME")
Components: stable
Signed-By: /etc/apt/keyrings/docker.asc
EOF

3. Update the package index to recognize the new repository:

sudo apt update

3️⃣ Step 3: Install Docker Packages

Once the repository is set up, execute the following command to install the Docker engine and related plugins directly from the repository:

sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

📦 Supplement: Offline Installation (Optional)

If you do not wish to set up the apt repository, or if the device cannot access the external internet to download packages, you can use the .deb package method.

1. Download Packages: On a PC with internet access, visit the official Docker repository path:

• URL: https://download.docker.com/linux/debian/dists/bullseye/pool/stable/arm64/
• Note: Ensure you select the architecture matching your device (typically arm64 for EG series).

2. Transfer Files: Use an SCP client (like WinSCP) to upload the downloaded .deb files to the gateway.
3. Install: Run the following command in the directory where the files were uploaded:

sudo dpkg -i package_name.deb

✅ Verification & Testing

After installation, it is critical to verify that the Docker service is active and capable of running containers.

1. Check Service Status

Run the following command to check if the Docker daemon is active and running:

sudo systemctl status docker

2. Run a Test Container (Optional)

To verify that the Docker client can communicate with the daemon and pull images, run the "hello-world" image:

sudo docker run hello-world

❓ Troubleshooting / FAQ

• Q: The apt update command fails or times out.

• A: Check the device's WAN connection.

• Q: I get a "Permission denied" error when running docker commands.

• A: Docker commands typically require root privileges. Ensure you are using sudo before the command (e.g., sudo docker ps).

• Q: I cannot find the sudo command.

• A: Ensure you are logged in with the user created on the Sudo User page within the System -> User Management section.

📜 Revision History