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

Network	Type	MLDonkey default	Default Container Setup	Configuration file
http_port	TCP	4080	4080	downloads.ini
telnet_port	TCP	4000	4000	downloads.ini
gui_port	TCP	4001	4001	downloads.ini
eDonkey2000	TCP	random	20562	donkey.ini
eDonkey2000	UDP	TCP port + 4	20566	donkey.ini
Kad	TCP	random	16965	donkey.ini, Kademlia section
Kad1	UDP	Same as TCP	16965	donkey.ini, Kademlia section
Overnet	TCP	random	6209	donkey.ini, Overnet section
Overnet	UDP	Same as TCP	6209	donkey.ini, Overnet section
BitTorrent Client	TCP	6882	6882	bittorrent.ini
BitTorrent Tracker	TCP	6881	6881	bittorrent.ini
BitTorrent DHT	UDP	random	3617	bittorrent.ini
DirectConnect	TCP	4444	4444	directconnect.ini
DirectConnect	UDP	Same as TCP	4444	directconnect.ini

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