aMule •

aMule is a browser-based interface for the peer-to-peer ED2K media download service, commonly known as eDonkey.  

Overview

emule2.PNG

aMule is a browser-based interface for the peer-to-peer ED2K media download service, commonly known as eDonkey.  

Media

Screenshots

aMule v2.3.3

emule2.PNG emule3.PNG emule4.PNG
emule5.PNG emule1.PNG

Setup & Configuration

We need to install the service through Portainer and configure any necessary settings.

Setup & Configuration

Preparation

There are some things we need to do in preparation to install this service.

Volumes

Persistent Data

This is where the service will store its own application data and ensures we can quickly update the service image.

Ensure your user has permissions to access the folder.

Download Folders

This service will need access to the folder where you will store their completed downloads.

Ensure your user has permissions to access the folder.

Environment

TZ

This is the current time zone formatted using the tz database.

For example: America/Vancouver

PUID

This is the numeric ID of the user account on Debian.  If you are unsure, open a terminal and run:

id -u
PGID

This is the numeric ID of the user account's group on Debian.  If you are unsure, open a terminal and run:

id -g
MOD_AUTO_RESTART_ENABLED

aMule is known to have issues that can cause it to stop working properly after a few days.  This setting allows the service to be restarted periodically to avoid this issue.

Recommended: true

MOD_AUTO_SHARE_ENABLED

This will automatically share all files and folders found within the MOD_AUTO_SHARE_DIRECTORIES variable.

Recommended: false

Passwords

Keep these securely stored in a password manager, such as VaultWarden.

GUI_PWD

This is the password for the administrator account that will be used within the web interface.

It is important to use secure passphrase that is easy-to-remember.

WEBUI_PWD

This is the password for the administrator account that will be used within the web interface.

It is important to use secure passphrase that is easy-to-remember.

Setup & Configuration

Installation

The service can be installed through the Portainer web interface. 

Learn about creating a new stack.

Docker Compose

Use the following code to install the service:

---
services:
  amule:
    image: ngosang/amule
    container_name: amule
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=America/Vancouver
      - GUI_PWD=
      - WEBUI_PWD=
      - MOD_AUTO_RESTART_ENABLED=true
      - MOD_AUTO_RESTART_CRON=0 6 * * *
      - MOD_AUTO_SHARE_ENABLED=false
      - MOD_AUTO_SHARE_DIRECTORIES=/incoming
      - MOD_FIX_KAD_GRAPH_ENABLED=true
      - MOD_FIX_KAD_BOOTSTRAP_ENABLED=true
    ports:
      - "4711:4711"
      - "4712:4712"
      - "4662:4662"
      - "4665:4665/udp"
      - "4672:4672/udp" 
    volumes:
      # Persistent Data
      - /srv/amule:/home/amule/.aMule

      # Download Folders
      - /mnt/downloads/incoming:/incoming
      - /mnt/downloads/temp:/temp
    restart: unless-stopped
Setup & Configuration

Updating

Re-Deploy the Stack

This service has been optimized for running in Docker.  

This allows you to re-deploy the stack through Portainer to download the latest updates. 

User Manual

Development

This software is released under the GPL-2.0 license. 

You can learn more about how to contribute to aMule through their GitHub. 

Resources

Official