Transmission Clutch HowTo
From SynologyWiki
This is a tutorial how to install transmission with it's additional webinterface (clutch) for the Synology-Boxes. It should work on the newer boxes with ARM/Marvell-chipsets, namely the DS107+, DS207 and CS407 as well as the ones with Freescale PPC CPU (DS107,DS207, CS407e, CS406, DS106, ...).
You need ipkg working for the things described here. You should maybe read this first if you are a beginner: Tips to get you around your Synology box.
Contents |
Transmission/Clutch
Transmission is a lightweight bittorrent client that runs on commandline on the synology boxes. It has a very nice webinterface, Clutch. In the end, you will only have to use clutch, not transmission directly. You can see a screenshot of clutch here.
Install the Programs
You need to install transmission, lighttpd and php.
ipkg install transmission lighttpd php php-fcgi
Lighttpd
Now you need to edit the lighttpd-configuration using your favourite editor. For beginners, I would recommend nano.
ipkg install nano nano /opt/etc/lighttpd/lighttpd.conf
Uncomment the "mod_fastcgi". To do that, remove the # at the beginning of the line.
Finally, restart lighttpd like this:
/opt/etc/init.d/S80lighttpd restart
If ypu see any errors, think closely about what you did and verify all the steps so far.
Clutch
Now, it's time to install clutch. Go to /opt/share/www/lighttpd/ and download clutch:
cd /opt/share/www/lighttpd/ wget http://clutchbt.com/Files/Clutch-0.4.tar.gz
Then unpack it und rename it's directory to something more meaningful:
tar -xvzf Clutch-0.4.tar.gz mv Clutch-0.4 clutch
Last thing to do for Clutch is to add the correct socket-path. The two programms communicate through that socket. You can do it like this:
echo "/root/.transmission/daemon/socket" > clutch/remote/data/socket.txt
Upgrading Clutch
There are somewhat recent updates to clutch, you can check for a new version yourself here every now and then.
The easiest way to upgrade is, in my opinion, to just remove the old clutch directory, download and unpack the new version and add the socket path again. You'll have to set your preferences (Port, UL/DL Rates, ..) again after this.
cd /opt/share/www/lighttpd/ rm -rf clutch wget [whatever the url to the recent version is] tar -xvzf [file you just downloded] mv [directory] clutch echo "/root/.transmission/daemon/socket" > clutch/remote/data/socket.txt
Of course, you'll have to edit the things in the [] yourself according to the version you're using.
Transmission
Time to set up transmission itself! The basic configuration is in /opt/etc/transmission.conf, but you can probably ignore most of the things there. Open it with nano
nano /opt/etc/transmission.conf
and make sure the following variables are set:
PIDFILE=/opt/var/run/transmission.pid ACTIVE=/root/active-torrents.txt HOME=/root/.transmission
Just to be on the safe side, create these two directories and make a softlink:
mkdir -p /root/.transmission mkdir -p /root/.config/ ln -s /root/.transmission /root/.config/transmission
Try to start the transmission-daemon and see if it gives any errors.
transmission-daemon
The daemons always runs in the background waits for you to add new torrents in Clutch. You do not need to interact with the daemon directly.
If you like, you can let transmission-daemon start automatically whenn your box starts. To do that, add transmission-daemon to /opt/etc/rc.optware like that:
nano /opt/etc/rc.optware
Then add a new line to the end that reads
/opt/bin/transmission-daemon &
Save and quit. Now it should autostart.
Finishing up
To access clutch, you can now go to http://diskstation:8081/clutch or http://diskstation:8081/lighttpd/clutch (depends on versions, just try both).
You can access the settings using the little button in the lower left, the rest should be pretty self-explanatory. Set the "Download to" directory to somewhere you on /volume1 and set the rest as you see fit.
If there are any problems, you can try starting transmission with the -f flag. This gives you some feedback when something is wrong.
transmission-daemon -f
Also, if there are problems with lighttpd or clutch, keep an eye on the console where you started lighttpd (or just open a console and restart it using /opt/etc/init.d/S80lighttpd restart).
