Difference between revisions of "Transmission"
Bulletmark (talk | contribs) m (→Installation: Added note about requiring transmission-cli for web-client) |
m (→Without Using the Systemd Service: transmission-daemon can also be run as standard user.) |
||
(5 intermediate revisions by 2 users not shown) | |||
Line 6: | Line 6: | ||
== Installation == | == Installation == | ||
− | |||
There are several options in [[official repositories]]: | There are several options in [[official repositories]]: | ||
+ | * {{Pkg|transmission-cli}} - CLI tools, daemon, and web client. | ||
+ | * {{Pkg|transmission-gtk}} - GTK+ GUI. | ||
+ | * {{Pkg|transmission-qt}} - Qt GUI. | ||
+ | * {{Pkg|transmission-remote-cli}} - Curses interface for the daemon. | ||
− | + | {{Note|The gtk client cannot connect to the daemon, so user wishing to use the daemon will need to consider using the qt package for a gui or the remote-cli package for a curses gui.}} | |
− | |||
− | |||
− | |||
− | |||
− | + | At a minimum, the -cli package is required. See note above when choosing between the -gtk and -qt packages. | |
== Configuration == | == Configuration == | ||
+ | Users need to make a decision regarding how transmission is to run on the system: | ||
+ | # As the transmission user daemonized (recommended for increased security). | ||
+ | # As their user without a daemon. | ||
− | + | === Using the Systemd Service (Recommended) === | |
− | + | Start the {{ic|transmission}} daemon [[systemd#Using units|using systemd]]. Customize the options using a transmission client or using the included webinterface accessible via http://localhost:9091 in a supported browser. Alternatively, the options can be modified using a text editor. The package default location is {{ic|/var/lib/transmission/.config/transmission-daemon/settings.json}} which should be edited while the daemon is not running. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | {{Note|The above is not created until the daemon is run initially.}} | |
− | + | A recommendation for those running daemonized is to create a shared directory with the correct permissions to allow access to both the transmission user, and system users. For example: | |
− | + | # mkdir /mnt/data/torrents | |
+ | # chown -R facade:transmission /mnt/data/torrents | ||
+ | # chmod -R 775 /mnt/data/torrents | ||
− | + | Now {{ic|/mnt/data/torrents}} is accessible for the system user '''facade''' and for the '''transmission''' group to which the '''transmission''' user belongs. Using chmod to make the target directory world read/writible is highly discouraged (i.e. do not chmod the dir to 777). There are multiple way to allow a directory to be used by several users/groups. Consult google for additional options. | |
− | + | === Without Using the Systemd Service === | |
+ | Both transmission-gtk and transmission-qt can function autonomously without a formal backend daemon. The default path of configuration files is under this scenario is {{ic|~/.config/transmission}}. | ||
− | + | When run with standard user rights, transmission-daemon configuration files are saved under {{ic|~/.config/transmission-daemon}}. By default the download location is set to {{ic|~/Downloads}}. | |
− | |||
− | {{ | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | == See | + | == See Also == |
*[https://trac.transmissionbt.com/wiki Transmission wiki] | *[https://trac.transmissionbt.com/wiki Transmission wiki] | ||
*[https://trac.transmissionbt.com/wiki/HeadlessUsage/General HeadlessUsage] | *[https://trac.transmissionbt.com/wiki/HeadlessUsage/General HeadlessUsage] |
Revision as of 13:44, 4 January 2014
zh-CN:Transmission Transmission is a light-weight and cross-platform BitTorrent client. It is the default BitTorrent client in many Linux distributions.
Contents
Installation
There are several options in official repositories:
- transmission-cli - CLI tools, daemon, and web client.
- transmission-gtk - GTK+ GUI.
- transmission-qt - Qt GUI.
- transmission-remote-cli - Curses interface for the daemon.
At a minimum, the -cli package is required. See note above when choosing between the -gtk and -qt packages.
Configuration
Users need to make a decision regarding how transmission is to run on the system:
- As the transmission user daemonized (recommended for increased security).
- As their user without a daemon.
Using the Systemd Service (Recommended)
Start the transmission
daemon using systemd. Customize the options using a transmission client or using the included webinterface accessible via http://localhost:9091 in a supported browser. Alternatively, the options can be modified using a text editor. The package default location is /var/lib/transmission/.config/transmission-daemon/settings.json
which should be edited while the daemon is not running.
A recommendation for those running daemonized is to create a shared directory with the correct permissions to allow access to both the transmission user, and system users. For example:
# mkdir /mnt/data/torrents # chown -R facade:transmission /mnt/data/torrents # chmod -R 775 /mnt/data/torrents
Now /mnt/data/torrents
is accessible for the system user facade and for the transmission group to which the transmission user belongs. Using chmod to make the target directory world read/writible is highly discouraged (i.e. do not chmod the dir to 777). There are multiple way to allow a directory to be used by several users/groups. Consult google for additional options.
Without Using the Systemd Service
Both transmission-gtk and transmission-qt can function autonomously without a formal backend daemon. The default path of configuration files is under this scenario is ~/.config/transmission
.
When run with standard user rights, transmission-daemon configuration files are saved under ~/.config/transmission-daemon
. By default the download location is set to ~/Downloads
.