Translation(s): English - Español - Italiano!Transmission_icon.png


Transmission is a light-weight and cross-platform BitTorrent client with full encryption, DHT, µTP, PEX and Magnet Link support. It is the default BitTorrent client for Debian Gnome.


If you have installed your Debian Gnome desktop from tasksel then transmission-gtk should be installed by default, but it is possible to use one more of the following packages, depending on your requirements:

Server installation

On a server you can install a BitTorrent daemon and connect to it using a web interface, by installing transmission-daemon.


The transmission-gtk and transmission-qt clients can be configured via the application or via ~/.config/transmission/settings.json.
The transmission-daemon can be configured by editing /etc/transmission-daemon/settings.json.

Configurating settings.json

Changes made manually to the file /etc/transmission-daemon/settings.json while the daemon is running will be silently overwritten on transmission exit. You need to stop it first, make changes and start it again.

service transmission-daemon stop
mcedit /etc/transmission-daemon/settings.json
service transmission-daemon start

The setting.json file is quite self explanatory but the common things that might need editing are:
(Full explanation here)

Change default user on the daemon

In case you want to set a different user than the default debian-transmission user, you need to create a configuration file to overwrite default settings.

# systemctl edit transmission-daemon.service

Then add these lines:


Where "USER" is the name of the user you want to run the daemon as.

The file is then located then in /etc/systemd/system/transmission-daemon.service.d/override.conf.
Or you can edit directly the file /etc/systemd/system/

Change permissions on download directory

If you have transmission on a server, you might want to edit downloaded files from local stations. Good choice is to make the download directory editable by a group of your stations users.

Change umask in settings.json to umask = 0 or even umask=7 (decimal explanation, the json markup language only accepts numbers in base 10). Finally change umask of the transmission daemon by adding UMask=007 to /etc/systemd/system/,

Connecting to the daemon

Web Interface

Once the daemon is running, it can be accessed from your web browser by pointing it at or if you come from local network http://ip-address-of-server:9091 (once you have whitelisted the IP range).

Command line app CLI and TUI

For connecting to a daemon from the shell you can use stig ( You can manipulate torrents and get stats. For example, with stig ls active you get active torrents.

Other possibilities

The are plenty of other ways to access the daemon - see

External Links