====== Configuration de Transmission ======

[[http://www.transmissionbt.com/|Transmission]] est un client BitTorrent léger multiplateforme disposant de plusieurs interfaces (Mac, Qt, GTK+, web, CLI). Sur une serveur Debian ne possédant pas d'interface graphique il peut être intéressant de mettre en place un client BitTorrent afin de profiter de la bande passante de la machine par exemple.

===== Installation =====

Sous Debian, il n'y a rien de plus simple.
<code bash>aptitude install transmission-daemon transmission-common transmission-cli</code>
On installe grâce à la commande ci-dessus l'interface web de Transmission, son démon ainsi que l'interface en ligne de commande.

===== Configuration =====

Le fichier de configuration de Transmission se situe dans le répertoire ///etc/transmission-daemon/// et porte le nom de //settings.json//. Il est possible ici de changer plusieurs valeurs pour obtenir la configuration souhaitée.
<note important>Il est important de stopper le démon avant de modifier le fichier.<code bash>service transmission-daemon stop</code></note>
Les paramètres à modifier le plus souvent sont :
  * **download-dir**, le répertoire où mettre les fichiers téléchargés,
  * **incomplete-dir**, le répertoire où mettre les fichiers en cours de téléchargements, et,
  * **rpc-***, les valeurs liées à RPC et à l'interface web.

===== Règles de firewall =====

Transmission faisant partie des applications qui utilisent le réseau, il est nécessaire d'ajouter quelques règles au firewall. Pour cela il faut se référer à cette [[gnu_linux_server:network_configuration:firewall|page]] et chercher les règles listées sous **Transmission**. Il faudra également ajouter les règles nécessaires pour pouvoir communiquer avec les trackers. Les trackers BitTorrent utilisant des ports différents, il écrire des règles au cas par cas.

===== Interface web =====

Transmission embarque une interface web ainsi qu'un serveur pour pouvoir contrôler à distance l'ajout, la suppression et la gestion de ses torrents. Pour activer l'interface web, il faut passer le paramètre **rpc-enabled** à la valeur **true**. Lorsque le démon va démarrer il va ainsi mettre à disposition l'interface web à une URL du type ''http://mon-serveur.com:9091''. Par défaut, il faut entrer un identifiant et un mot de passe. Il est possible de modifier ceci. Par exemple, pour changer le port utilisé par l'interface web, on change le paramètre **rpc-port**. Pour changer de nom d'utilisateur et le mot de passe on modifie **rpc-username** et **rpc-password** respectivement. Il faut indiquer le mot de passe en clair, celui-ci sera chiffré automatiquement au démarrage du démon.