Skip to content
Branch: master
Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Transmission README

Transmission is a set of lightweight BitTorrent clients (in GUI, CLI and daemon form). All these incarnations feature a very simple and intuitive interface, on top on an efficient, cross-platform backend:

Transmission is intended to download KA Lite content to Internet-in-a-Box (IIAB) from places like — and also to seed content, assisting others.

For example, once KA Lite videos and thumbnails are confirmed downloaded, copy them (carefully!) from /library/transmission into /library/ka-lite/content as outlined by "KA Lite Administration: What tips & tricks exist?" at http://FAQ.IIAB.IO


Usage of Transmission consumes significant Internet data and system resources. Caveat emptor! (That's Latin for "Buyer Beware")

Using It

Install Transmission by setting 'transmission_install' and 'transmission_enabled' to True in /etc/iiab/local_vars.yml — carefully choosing language(s) for KA Lite videos you want to download — and then run:

cd /opt/iiab/iiab
./runrole transmission

Or if you prefer a complete reinstall of IIAB:

cd /opt/iiab/iiab
./iiab-install --reinstall

Login to Transmission's web interface http://box:9091 using administrative account:

Username: Admin
Password: changeme

Alternatively, you can run transmission-remote at the command-line.


Configure Transmission using its web interface: http://box:9091

More settings can be changed within /etc/transmission-daemon/settings.json if you first ensure that the transmission-daemon.service is stopped:

systemctl stop transmission-daemon

Then edit the file:

nano /etc/transmission-daemon/settings.json

Here are some short explanations, as to what those 70+ variables mean:

After saving your changes in 'settings.json' restart Transmission by running:

systemctl restart transmission-daemon

Adding Torrents

Transmission can facilitate provisioning content onto your IIAB, e.g. by adding thousands of KA Lite videos from places like:

Please read the lettered instructions (A, B, C, D) in /etc/iiab/local_vars.yml and 'KA Lite Administration: What tips & tricks exist?' at http://FAQ.IIAB.IO outlining how to use Transmission to download and then install KA Lite content.

You can also download other torrents using Transmission's web interface, or by typing 'transmission-remote' at the command-line:

transmission-remote -a <path_to_the.torrent>

Known Issues

  • Default Transmission user/group may need fixing ( in some circumstances. You can set Ansible variables 'transmission_user' and 'transmission_group' e.g. in /opt/iiab/iiab/roles/transmission/defaults/main.yml (you might need 'User=' and 'Group=' in systemd unit file /lib/systemd/system/transmission-daemon.service — e.g. both might need to be set to 'debian-transmission' — if so then run 'systemctl daemon-reload' and 'systemctl restart transmission-daemon').
  • Random Ports: Currently it is not possible to use random ports in the range 49152-65535. It is difficult to open multiple ports in IIAB's iptables-based firewall.


Verify that transmission-daemon is running:

systemctl status transmission-daemon

Re-check that Transmission's settings are correct here: (by following the instructions above, under 'Configuration')

You can’t perform that action at this time.