{{tag>en en:linux en:server en:file_transfert}}
====== MLDonkey ======

MLDonkey is client for P2P networks under Linux. 

The supported protocols are :
  * eDonkey2000
  * Overnet
  * BitTorrent
  * Gnutella (LimeWire)
  * Gnutella2
  * FastTrack
  * FileTP: HTTP, FTP and SSH
  * Kad Network 

Moreover, it can be managed by several ways :
  * web interface (4080)
  * telnet (4000)
  * GUI (4001) available list here : [[http://mldonkey.sourceforge.net/Gui|MLDonkey Gui]]


===== Installation =====
==== Package ====
To install mldonkey server, add the package :
  * mldonkey-server

Mldonkey is installed by default in the folder ///var/lib/mldonkey//.

Once the install done, mldonkey is only reachable from the localhost 127.0.0.1

===== Setup =====
The following paragraps details how to customize the installation.\\
Then all other tunning can be done through the web interface.


==== Define the admin network ====
To allow access from other computers, we need to edit ///var/lib/mldonkey/downloads.ini// :
  * stop mldonkey : /etc/init.d/mldonkey-server stop
  * modify the option "allowed_ips" into ///var/lib/mldonkey/downloads.ini// :

<file> 
 allowed_ips = [
  "127.0.0.1"; "192.168.10.0/24"; "192.168.11.0/24";]
</file>

  * start mldonkey : /etc/init.d/mldonkey-server start

==== Change the password ====
To protect the access, we need to setup a password with useradd command (telnet) :
<code>
# telnet localhost 4000
Trying 127.0.0.1...
Connected to localhost.localdomain.
Escape character is '^]'.
Welcome to MLDonkey 3.0.0
Welcome on mldonkey command-line

Use ? for help

> useradd admin xxx
Password of user admin changed
</code>


===== Administration =====
It's possible to manage mldonkey from several ways.

==== Interfaces ====
  * HTTP : 4080
  * telnet : 4000
  * GUI : 4001 list available here : [[http://mldonkey.sourceforge.net/Gui|MLDonkey Gui]]

==== Incoming connections to allow on the firewall ====

^Network 	^Type    ^Historical default ^MLdonkey default                   ^Configuration file          ^
|eDonkey2000    |TCP     |4662 	             |port = random (before 2.8.0: 4662) |donkey.ini                  |
|eDonkey2000    |UDP     |4672 (eMule)       |TCP port + 4 (before 2.8.0: 4666)  |donkey.ini                  |
|Kad            |TCP     |6419 (eMule)       |Kademlia.port = random             |donkey.ini, Kademlia section|
|Kad1           |UDP     |6429 (eMule)       |Same as TCP                        |donkey.ini, Kademlia section|
|Overnet        |TCP     |4662               |Overnet.port = random              |donkey.ini, Overnet section |
|Overnet        |UDP     |No default         |Same as TCP                        |donkey.ini, Overnet section |
|Gnutella       |TCP     |6346               |client_port = 6346                 |gnutella.ini                |
|Gnutella       |UDP (??)|Same as TCP        |client_port = 6346                 |gnutella.ini                |
|Gnutella2      |TCP     |No default         |client_port = 6347                 |gnutella2.ini               |
|Gnutella2      |UDP     |Same as TCP        |client_port = 6347                 |gnutella2.ini               |
|BitTorrent     |TCP     |6881               |client_port = 6882                 |bittorrent.ini              |
|FastTrack      |TCP     |1214               |client_port = 1214                 |fasttrack.ini               |
|OpenNapster    |TCP     |6699               |client_port = 9999                 |opennap.ini                 |
|DirectConnect  |TCP     |1412               |client_port = 4444                 |directconnect.ini           |
|Direct Connect |UDP     |Same as TCP        |client_port = 4444                 |directconnect.ini           |
|Soulseek       |TCP     |2234               |client_port = 2234                 |soulseek.ini                |


==== Tunning ====
Some usefull parameters :
  * client name : Options > Client > client_name
  * maximum upload rate : Options > Client > max_hard_upload_rate (kB/s)
  * maximum download rate : Options > Client > max_hard_download_rate (kB/s)
  * number of connections allowed : Options > Client > max_opened_connections : 929
  * number of indirect connections allowed : Options > Client > max_indirect_connections (percentage of max_opened_connections)
  * maximum connection per second allowed : Options > Client > max_connections_per_second : 100
  * maximum simultaneous downloads : Options > Client > max_concurrent_downloads : 100
  * send an email on completion : Options > Mail

clients parameters by protocol :
  * incoming eDonkey port : Options > Plugins > Donkey > ED2K-Ports : 4662
  * force the High ID : Options > Plugins > Donkey > ED2K-force_high_id : true

For information, there is two kind of ID with eDonkey :
  * high ID : it's the public IP of the client when it is directly reachable from the Internet
  * low ID : ID given by servers when the client is not reachable directly
Two low ID cannot connect together.


===== Backup =====
  * /etc/default/mldonkey-server
  * /var/lib/mldonkey/downloads.ini
  * /var/lib/mldonkey/donkey.ini

===== Links =====

  * http://mldonkey.sourceforge.net