logicwar/mldonkey repository overview

⁠Docker Container for MLDonkey⁠

This is a Docker image based on osixia/light-baseimage for running MLDonkey 3.1.6.

MLDonkey is an open source, multi-protocol, peer-to-peer file sharing application that runs as a back-end server application on many platforms. It can be controlled through a user interface provided by one of many separate front-ends, including a Web interface, telnet interface and over a dozen native client programs. Wikipedia⁠

MLDonkey is free software, released under the terms of the GNU General Public License.

⁠Usage

docker create --name=mldonkey \ 
              -v <path for config files>:/var/lib/mldonkey:rw \
              -v <path for temporary files>:/mnt/mldonkey_tmp:rw \
              -v <path for completed downloaded files>:/mnt/mldonkey_completed:rw \
              -e PGID=<gid>
              -e PUID=<uid> \
              -e TZ=<timezone> \
              -p 4000:4000 \
              -p 4001:4001 \
              -p 4080:4080 \
              -p 20562:20562 \
              -p 20566:20566/udp \
              -p 16965:16965 \
              -p 16965:16965/udp \
              -p 6209:6209 \
              -p 6209:6209/udp \
              -p 6881:6881 \
              -p 6882:6882 \
              -p 3617:3617/udp \
              -p 4444:4444 \
              -p 4444:4444/udp \
              logicwar/mldonkey

⁠Parameters

• -p 4000 - Telnet port
• -p 4001 - GUI port
• -p 4080 - HTTP port for the Web interface
• -p 20562 - eDonkey2000 port
• -p 20566/udp - eDonkey2000 port
• -p 16965 - Kad port (disabled by default)
• -p 16965/udp - Kad1 port (disabled by default)
• -p 6209 - Overnet port (disabled by default)
• -p 6209/udp - Overnet port (disabled by default)
• -p 6881 - BitTorrent Client port (disabled by default)
• -p 6882- BitTorrent Tracker port (disabled by default)
• -p 3617/udp - BitTorrent DHT port (disabled by default)
• -p 4444 - BitTorrent DHT port (disabled by default)
• -p 4444/udp - BitTorrent DHT port (disabled by default)
• -v /var/lib/mldonkey - where LMS stores config and log files
• -v /mnt/mldonkey_tmp - local path for your audios
• -v /mnt/mldonkey_completed - local path for your playlists
• -e PGID for GroupID - see below for explanation
• -e PUID for UserID - see below for explanation
• -e TZ for timezone information : Europe/London, Europe/Zurich, America/New_York, ... (List of TZ⁠)

For shell access while the container is running do docker exec -it mldonkey /bin/bash

⁠User / Group ID

For security reasons and to avoid permissions issues with data volumes (-v flags), you may want to create a specific "docker" user with proper right accesses on your persistant folders. To find your user uid and gid you can use the id <user> command as below:

  $ id <dockeruser>
    uid=1001(dockeruser) gid=1001(dockergroup) groups=1001(dockergroup)

and finally specify your "docker" user PUID and group PGID. In this exemple PUID=1001 and PGID=1001.

⁠Setting up the application

The intitial setup is made by browsing to http://your_server_IP:4080 and begin configuring the MDDonkey Server.

The first thing to do is to set a password for the admin user. you can use the command in the input field: useradd admin <your_password>

By default only eDonkey is enabled. To enable the other networks go to Options->Net and set to true what you need.

⁠Container default configuation

⁠Versions

• V0.2 Updated to to osixia/light-baseimage 1.3.3 and MLDonkey 3.1.6 , delete at boot "*.ini.tmp" files to ensure proper Core start
• V0.1 Initial Release 3.1.5