westnetdocker/firefox-arm repository overview

⁠Firefox Web Browser for ARM Peplink Edge Compute Devices (Alpine-Based)

⁠Overview

This Docker image provides a lightweight Firefox ESR instance running on Alpine Linux, optimized for ARM-based Peplink Edge Compute Devices. It is accessible via Remote Desktop Protocol (RDP) using the InTouch feature.

⁠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-firefox-alpine-arm.
   • 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 westnetdocker/firefox-arm
       

       Copy
     • With a custom password:

       docker run --name nameofcontainer -p 3389:3389 -e PASSWORD=yourcustompassword westnetdocker/firefox-arm
       

       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: Special characters (e.g., &, !, #) in custom passwords may cause issues due to shell interpretation. Enclose the password in single quotes (e.g., 'my&pass') when running manually.
     • Port 3389 is exposed for RDP access via InTouch.
     • Use --ip x.x.x.x to set a custom IP address.
     • Use --network vlan10 to set the container on VLAN 10.

4. Grab the IP Address:

   • Note the IP address assigned to the container.

⁠Connecting to Firefox via InTouch

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.
   • Firefox ESR will launch automatically.

⁠Features

• Lightweight Firefox Instance: Runs Firefox ESR on a minimal Alpine Linux base with Openbox as the window manager.
• InTouch Integration: Designed for easy access via Peplink’s InTouch RDP feature.
• Customizable Password: Set via the PASSWORD environment variable during container creation.

⁠Notes

• The image is built for ARM architecture (linux/arm64) using Alpine Linux (latest version) as the base.