transmission-daemon(1)

1TRANSMISSION-DAEMON(1)    BSD General Commands Manual   TRANSMISSION-DAEMON(1)
2

NAME

4     transmission-daemon — a bittorrent client
5

SYNOPSIS

7     transmission-daemon -h
8     transmission-daemon [-a x.x.x.x,...] [-b | -B] [-c directory] [-C] [-d]
9                         [-f] [-g directory] [-h] [-p port] [-t | -T]
10                         [-u username] [-v password] [-P port] [-m | -M]
11                         [-l limit] [-L limit] [-er | -ep | -et]
12                         [-utp | -no-utp] [-V] [-w download-dir] [-e logfile]
13                         [-log-error | -log-info | -log-debug]
14

DESCRIPTION

16     transmission-daemon is a daemon-based Transmission session that can be
17     controlled via RPC commands from transmission's web interface or
18     transmission-remote(1).
19

OPTIONS

21     -a --allowed x.x.x.x,...
22             Allow RPC access to a comma-delimited whitelist of IP addresses.
23             Wildcards can be specified in an address by using '*'.  Default:
24             "127.0.0.1" Example: "127.0.0.*,192.168.1.*"
25
26     -b --blocklist
27             Enable peer blocklists. Transmission understands the bluetack
28             blocklist file format.  New blocklists can be added by copying
29             them into the config-dir's "blocklists" subdirectory.
30
31     -c directory
32             Directory to watch for new .torrent files to be added. As they
33             are added to this directory, the daemon will load them into
34             Transmission.
35
36     -C      Do not watch for new .torrent files.
37
38     -B --no-blocklist
39             Disble blocklists.
40
41     -d      Dump transmission-daemon's settings to stderr.
42
43     -f --foreground
44             Run in the foreground and print errors to stderr.
45
46     -g --config-dir directory
47             Where to look for configuration files. This can be used to swap
48             between using the cli, daemon, gtk, and qt clients.  See
49             https://github.com/transmission/transmission/wiki/Configuration-
50             Files for more information.
51
52     -er --encryption-required
53             Encrypt all peer connections.
54
55     -ep --encryption-preferred
56             Prefer encrypted peer connections.
57
58     -et --encryption-tolerated
59             Prefer unencrypted peer connections.
60
61     -gsr --global-seedratio ratio
62             All torrents, unless overridden by a per-torrent setting, should
63             seed until a specific ratio
64
65     -GSR --no-global-seedratio
66             All torrents, unless overridden by a per-torrent setting, should
67             seed regardless of ratio
68
69     -h --help
70             Print command-line option descriptions.
71
72     --incomplete-dir dir
73             When adding new torrents, store their contents in directory until
74             the torrent is done.
75
76     --no-incomplete-dir
77             Don't store incomplete torrents in a different directory.
78
79     -i --bind-address-ipv4
80             Listen for IPv4 BitTorrent connections on a specific address.
81             Only one IPv4 listening address is allowed. Default: 0.0.0.0 (All
82             addresses)
83
84     -I --bind-address-ipv6
85             Listen for IPv6 BitTorrent connections on a specific address.
86             Only one IPv6 listening address is allowed. Default: :: (All
87             addresses)
88
89     -r --rpc-bind-address
90             Listen for RPC connections on a specific address. This must be an
91             IPv4 address. Only one RPC listening address is allowed. Default:
92             0.0.0.0 (All addresses)
93
94     --paused
95             Pause all torrents on startup
96
97     -L --peerlimit-global limit
98             Overall peer limit. Useful on embedded systems where the default
99             might be unsuitable. Default: 240
100
101     -l --peerlimit-torrent limit
102             Peer limit per torrent. Useful on embedded systems where the
103             default might be unsuitable. Default: 60
104
105     -m --portmap
106             Enable portmapping via NAT-PMP or UPnP
107
108     -M --no-portmap
109             Disable portmapping
110
111     -o --dht
112             Enable distributed hash table (DHT).
113
114     -O --no-dht
115             Disable distribued hash table (DHT).
116
117     -p --port port
118             Port to open and listen for RPC requests on. Default: 9091
119
120     -P, --peerport port
121             Port to listen for incoming peers on. Default: 51413
122
123     -t --auth
124             Require clients to authenticate themselves.  This doesn't do much
125             good unless username and password are also set.
126
127     -T --no-auth
128             Don't require authentication from clients.
129
130     -u --username username
131             Used for client authentication.
132
133     -v --password password
134             Used for client authentication.
135
136     -V --version
137             Show version number and exit
138
139     --utp   Enable uTP for peer connections.
140
141     --no-utp
142             Disable uTP for peer connections.
143
144     -w --download-dir
145             Where to store downloaded data.
146
147     -e --logfile
148             Where to store transmission's log messages.
149
150     --log-error
151             Show error messages
152
153     --log-info
154             Show error and info messages
155
156     --log-debug
157             Show error, info, and debug messages
158

ENVIRONMENT

160     http_proxy  libcurl uses this environment variable when performing
161                 tracker announces.
162
163     TRANSMISSION_HOME
164                 Sets the default config-dir.
165

FILES

167     ~/.config/transmission-daemon
168             The config-dir used when neither [TRANSMISSION_HOME] nor [-g] is
169             specified.  See https://github.com/transmission/transmis‐
170             sion/wiki/Configuration-Files for more information.
171

AUTHORS

173     Jordan Lee, Josh Elsasser, Eric Petit, and Mitchell Livingston.
174