westnetdocker/peplink-tools-arm-lite repository overview

⁠GUI & CLI Tools Desktop for ARM Peplink Edge Compute Devices

⁠Overview

This Docker image provides a lightweight desktop environment with a suite of command-line network tools and Speedtest CLI along with Firefox, optimized for ARM-based Peplink Edge Compute Devices. It includes utilities like iperf3', speedtest`, and more, along with a graphical interface accessible via RDP.

⁠Default Login Information

• Username: peplink
• Password: peplink

⁠How to Run the Docker Container

1. Access the Web Admin Interface:

   • Open the Web Admin or Remote Web Admin interface for your Peplink router.
   • Navigate to the Advanced tab.

2. Install the Docker Image:

   • Click on Docker.
   • Click Here to Pull Image.
   • Type in westnetdocker/peplink-tools-arm-lite.
   • Click OK and wait for the image to be installed.

3. Run the Docker Container:

   • Click the Plus Sign (+) to add a new container.
   • Use one of the following Docker commands:
     • Without a custom password:

       docker run --name nameofcontainer -p 3389:3389 -p 22:22 westnetdocker/peplink-tools-arm-lite
       

       Copy
     • With a custom password:

       docker run --name nameofcontainer -p 3389:3389 -p 22:22 -e PASSWORD=yourcustompassword westnetdocker/peplink-tools-arm-lite
       

       Copy
     • Replace nameofcontainer with a desired name for your container.
     • If you do not specify a custom password, the default credentials (peplink / peplink) will be used.
     • Note: Port 22 is exposed for SSH access in addition to 3389 for RDP.
     • Use --ip x.x.x.x to set a custom IP address.
     • Use --network vlan10 to put the container on VLAN 10.

4. Grab the IP Address:

   • Note the IP address assigned to the container.

⁠Connecting to CLI Tools Desktop

1. Configure InTouch for RDP:

   • Open the InTouch interface and click Add.
   • Change the connection type to RDP.
   • Enter the following details:
     • Username: peplink
     • IP Address: The container’s IP address
     • Password: The default (peplink) or your custom password
     • Port: 3389
   • Save changes.
   • Hit the Play Button in InTouch to establish the connection.

2. Direct Access via RDP:

   • Use any Remote Desktop Protocol (RDP) client to connect directly to the container.
   • Enter the container's IP address, username (peplink), password (default or custom), and port 3389 to connect.

⁠Features

• Graphical Interface: Includes Openbox with a dark-themed desktop and Firefox ESR.
• Network Tools: Pre-installed tools include speedtest, iperf3, nmap, tcpdump, wireshark, hping3, ntp, snmp, nuttcp, and more.
• Customizable Password: Set via the PASSWORD environment variable during container creation.